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(57) Abstract: A linking engine providing a process of matching the logic of an application, described in an application logic unit, 
whith the hardware specific description of the application for use with applications run on smart card terminals. The hardware 
specific description of the application is contained in dictionaries. The linking engine tests dictionaries for compatibility with the 
application logic unit by ninnning a process that returns a predeterrnined response only when the dictionary describes the hardware 
implementation used in the test A dictionary outputfing the correct response is linked by the linking engine to provide the description 
of the hardware implemented in running the logic of the application. 
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METHOD AND SYSTEM OF LINKING A SMART DEVICE DESCRIPTION FILE 
WITH THE LOGIC OF AN APPLICATION PROGRAM 



BACKGROUND — 

5 Field of the Invention 

The present invention relates to the field of smart devices. More particularly, the 

- present invention relates to the field of application software.used in connection with a smart^ 

device. 

Related Background 

1 0 Smart devices, such as smart cards, smart watches, smart tags, or other portable 

objects with the ability to either process data or store data, interface with other processing 
devices to provide a functional implementation. Examples of functional implementations, or 
uses, of the smart device include stored value (often referred to as an electronic purse), 
loyalty award programs, secure access, secure authentication, as well as many other uses. 

15 Figure 1 is a block diagram of a conventional smart device system (1). A smart 

device (2) is in communication with a terminal (3). Application software that runs on the 
terminal (3) is often referred to as an "application" (4). Applications (4) interfaces with the 
terminal hardware (5) through an Application Programming Interface (API) (6). The API is 
assembled of smart device interfaces that support applications. Typically, the API runs on 
20 top of a layer of software (not shown) which interacts directly with the terminal hardware. 
Examples of such layers include the Open Card Framework (OCF) layer, the Personal 
Computer to Smart Card (PC-SC) layer, and the Sun™ initiative layer. 

Application software, often referred to as "applets" (7), for processing data on the 
smart device (2) run on the smart device and interact with the smart device hardware (8) 
25 through the smart device operating system (OS) (9). The application (4) running on the 

terminal (3) interfaces with the applet (7) through the API (6), terminal hardware (5), and the 
smart device hardware (8). 
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Data is downloaded/uploaded to the smart device (2) by the terminal (3). The 
terminal can be either of the contact or contactless type. In contact type smart devices 
contact tabs of the terminal establish communication with the smart device through physical 
contact with contact pads located on the smart device. In contactless terminals radio 

frequency (RF) is typically used to provid^om^rii^ioh^ 

contactless terminals can use optical, microwave, or other communication methods. 

Because memory space is at a premium in terminals, conventional APIs are optimized 
to support a specific"fiinctional implementation of a particular terminal-device combination. 
For example, an API designed for use with a smart device functioning as an electronic purse 
is optimized to support those functions commonly used in implementing electronic purse 
applications. Similarly, an API designed to support loyalty award applications, such as 
airline frequent flyer rewards program, is optimized to support those functions commonly 
used in implementing loyalty applications: Electronic purse applications would typically not 
be interoperable with loyalty APIs as such APIs would not support the electronic purse 
functionality. Similarly, loyalty applications and applets are typically not interoperable with 
electronic purse APIs. In this manner applications intended for a given functional 
implementation, such as loyalty, are typically only interoperable with APIs for the same 
functional implementation. 

APIs are typically optimized to work with a particular smart device from a particular 
manufacturer. An API for a particular manufacturer's electronic purse smart device supports 
different application functionalities than an electronic purse API designed for another 
manufacturer's smart device. Additionally, even different models of electronic purse smart 
devices from a particular manufacturer may require a different APIs that are not interoperable 
with applications written for the other models of electronic purse smart devices from the 
same manufacturer. APIs are also typically optimized to work with a particular reader. Thus, 
an application written for a given API may be capable of being used with a small subset of 
available smart devices in combination with a particular set of readers. This results in a lack 
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of interoperability of applications written for loyalty across APIs for cards from different 
manufacturers and for particular terminals. 

This lack of interoperability of applications across the proliferation of APIs optimized 
for specific smart devices, terminals and functionalities reduces the ability for developers to 
create applications that can be implemented on a wide variety of smart^evicesT The present — 
design of conventional APIs requires developers to write and develop applications for use 
with a specific, or a specific set, of APIs. Consequently, applications written in this manner 

are only usefiil with~a limited number of smart devices and terminals. 

Existing programming interfaces have attempted to solve the problems associated 
with the lack of flexibility with conventional APIs. One attempt at providing greater 
interoperability among applications and APIs is the Java programming language 

Figure 2 is a block diagram illustrating the architecture of a typical Java™ card 
system (10). A Java card (1 1) is a conventional smart device that may run Java applets (12). 
Java applets (12) are executed by the smart card Java card virtual machine (JCVM) (13). 
The JCVM (13) runs on top of the smart card's OS (14). The OS (14) interfaces with the 
hardware (1 5) of the smart card. Java applications (16) run on the JVM (17) of the terminal 
(18). The terminal (1 8) is in communication with the Java card (1 1) can be either a contact or 
contactless terminal. Applications interface with the hardware of the terminal (19), the 
hardware of the Java card, and the Java applet through the API (20). Like the API (6) of 
Figure 1, the API (20) interfaces with the application to support the functionality of the 
intended use of the Java card. Because of the premium on memory of the terminal, the API 
typically is optimized to support the functionality for the intended use of the smart card. 
Thus, an API optimized for electronic purse applets would typically not be able to support 
loyalty applications. Similarly, an API optimized for loyalty would not be able to support 
electronic purse applications. In this manner, the Java card has the same disadvantages of 
the conventional smart card architecture shown in Figure 1. 
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Attempts to allow interoperability of applications, in either the conventional 
architecture of Figure 1, or the Java card architecture of Figure 2, result in a loss of 
supporting functions for applications written for the intended use of the card. The 
architectures of the presently available smart card systems force designers to make a trade off 

5 between interoperability and functionality, with most ^stem^cHw'sihg "functionality over 

interoperability. 

Attempts to increase the interoperability of conventional APIs by increasing the 
functions the API supports has the disadvantage of increasing the-footprint of the AEI,.i.e. _the 
memory required to store the API on the terminal. This has the disadvantage of increasing 
1 0 the cost and complexity of the terminal. 

The conventional architecture of applications and APIs also has the disadvantage that 
when a new smart device or terminal is introduced, often with a new functionality, existing 
applications often are not interoperable with an API intended for the new smart device or 
terminal. An API released prior to the development of the new functionality would not 
1 5 support new functionalities. 
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Brief Description of the Figures 
Figure 1 is a block diagram depicting the application system architecture of a 
conventional smart card. 

Figure 2 is a block diagram depicting the application system architecture of a 

5 conventional Java™ card system? - 

Figure 3 is a block diagram of an application for the smart device including an 
application logic unit and an application protocol, in accordance with the present invention. 

Figure 4 depicts thearchitecture ofthe application and linking engine^in accordance 
with the present invention. 
0 Figure 5 is a flow chart illustrating the process implemented by the linking engine in 

running the application, in accordance with the present invention. 

Figure 6 is a flow chart illustrating the process of selecting the appropriate dictionary 
for the hardware implementation used at the run time ofthe application logic unit, in 
accordance with the present invention. 
5 Figure 7 is flow chart illustrating the process of running an application in accordance 

with the present invention. 

SUMMARY 

The present invention provides a linking engine for smart devices which links the 
20 logic ofthe application, the application logic unit, to a hardware specific description ofthe 
application, the application protocol. An application logic unit is written in a conventional 
computer language and expresses the logic of the application without regard for the specific 
hardware implementation of the terminal and smart device. During run time the linking 
engine looks up the appropriate dictionaries corresponding to the hardware elements. Each 
25 dictionary has a boot process which, when run, outputs a predetermined response when the 
hardware used is the hardware the dictionary describes. In this manner dictionaries retrieved 
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from a set of dictionaries are tested to find the dictionary appropriate for the terminal and 
smart device present when the application logic unit is to be run. 

DETAILED DESCRIPTION 

5 The present invention is described in the context of a specific embodiment. Thisls 

done to facilitate the understanding of the features and principles of the present invention 
and the present invention is not limited to this embodiment. In particular, the present 

invention is described in the context of a smart device. ~Exampres~6f smart" devices ~ 

applicable to the present invention include, without limitation, smart cards, smart watches, 

10 smart tags, smart wristbands, and smart pendants. Smart devices can be either of the 
processor type, where the device has the ability to run applets to process data, or of the 
memory type, where the device is sued to store data. Additionally, the present invention is 
described in the context of a terminal. A terminal can be any computing device capable, by 
itself or with other devices, of communicating with a smart device. Examples of terminals 

1 5 include, without limitation, personal computers, server computers, hand-held computers, 

point of sale terminals, portable phones and communication devices, and computer networks. 

In the following figures like objects are provided with the same identifying number as 
an aid in understanding the present invention. 

20 Figure 3 is a block diagram depicting the architecture of an application program 

(application) (30) in accordance with the present invention. The application typically runs on 
a terminal in communication with a smart device. Applications can be any implementation of 
the processing of data. Typical examples of applications include the debit functions in an 
electronic purse card, credit and add loyalty points in a frequent flyer program card, key 

25 generation in a security authorization card, memory retrieval in a medical history card, or 
security and memory functions common to many card implementations. 
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The application (30) of the present invention is segregated into two categories of 
software to form the application. The application (30) is composed of an application logic 
unit (31) and an application protocol (32). The application logic unit is the logic of the 
application, independent of the hardware implementation. The application protocol is a 
5 hardware specific component of the application and provides the data and rules necessary to 
implement the logic of the application protocol on a specific hardware implementation. 
Figure 4 is a block diagram of the architecture of the application logic unit (3 1 ), 
~linkingengine"(33) and terminarhafdware"(34). The' application logic unit interacts with the ~~ 
linking engine to link an application protocol to the application logic unit. The linking engine 
10 interacts with a set of dictionaries (35) containing at least one dictionary (36). A dictionary 
(36) includes a description (37) relating to the terminal hardware (34) and to the smart card 
hardware (not shown). More particularly, the dictionary includes a series of verbs (not 
shown). The verbs are described in the body of the dictionary, the description being the 
definition of the verb. The definition of the verb is the hardware specific component of the 
15 application. The set of dictionaries (35) are specified in a boot file (38). The boot file is used 
by the linking engine (33) in testing the dictionary to determine whether that dictionary is the 
appropriate dictionary for the smart device and terminal present at the run time of the 
application. The appropriate dictionary is used as the application protocol which, when 
linked to the application logic unit, provides the hardware specific component of the 
20 application 

Figure 5 is a flow chart of the process the linking engine utilizes in running an 
application. In the presently preferred embodiment of the present invention the linking 
engine has been established and the application logic unit has initiated a boot check request 
prior to step (40), as described below in connection with Figure 7. At step (40) the linking 
25 engine waits for an indication that a smart device is in communication with the terminal. 
When a positive indication is received, i.e. when there is a smart device in communication 
with the terminal, the linking engine proceeds to step (41) to initiate a compatibility test for 
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the dictionary to use as the application protocol. The process of selecting a dictionary for use 
as the application protocol is described below in connection with Figure 6. At step (42) the 
linking engine receives from the application protocol selection process the identifier of the 
compatible dictionary to use as the application protocol. The dictionary corresponding to the 
identifier isusedas the application protocol:^ The linking engine then proceeds to step (43) to 
wait for a method call from the application logic unit. 

In response to a method call from the application logic unit the linking engine 

. -proceeds.to step (44) toJook-up the.method in the.application protocol. At step (45)_the 

linking engine determines whether a verb corresponding to the method exists in the 
application protocol. If the verb does not exist, the linking engine returns to step (44) to wait 
for a method call from the application logic unit. If the verb does exist in the application 
protocol, the linking engine proceeds to step (46) where the linking engine retrieves the 
definition from the application protocol and links the definition to the method call from the 
application logic unit. The linking engine then uses the verb's definition at step (47) in 
executing the method call from the application logic unit. The description in the application 
protocol of the hardware is used to generate responses to the method call. The responses 
generated at step (47) from executing the method call according to the rules and data of the 
definition are then returned to the application logic unit at step (48). The linking engine 
returns to step (43) to wait for a method call from the application logic unit. 

The linking engine may return a critical fault to the application logic unit in response 
to any condition which jeopardizes the proper execution of the application logic unit. The 
conditions which may give rise to a critical fault include the absence from the application 
protocol of a critical definition, absence from the application protocol of critical rules or data, 
absence of critical data from the application logic unit being passed to the method call, 
problems with the data used in the method call, or an inappropriate responses to executing the 
method call. In the preferred embodiment of the present invention, the conditions that trigger 
a critical fault are included in the application protocol. 
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Figure 6 is a flow chart illustrating the process used by the linking engine in selecting 
a dictionary for use as the application protocol with a given terminal and smart device. At 
step (50) the linking engine receives a boot check request, or dictionary selection request, 
from an application logic unit. In response, at step (51) the linking engine retrieves a list of 

5 potentially compiHibl^iaiohffie]^ 

invention, the list of potentially compatible dictionaries includes those dictionaries specified 
as potentially compatible with the application logic unit, the terminal and the smart device. 

- - More preferably^ the dict ionaries-included on list of potentially compatible dictionaries are 

pre-selected to include dictionaries that are compatible with the terminal and application logic 

10 unit. In such a case, the list of dictionaries is inclusive of all the dictionaries that may be 

needed to provide a description compatible with any smart devices available for use with the 
application and terminal. 

The list of dictionaries is located on a file separate from the application logic unit. 
This file is referred to as the boot file. As the boot file is separate from the application logic 

1 5 unit this file can be updated to add dictionaries, as when a new smart device is introduced, 
without the need to modify the application logic unit. Additionally, the boot file includes an 
address specifying where to find the dictionary. Depending on the implementation of the 
terminal and smart device the dictionary can be located on a computer accessible by the 
terminal through a network or Internet connection, or the dictionary can be stored in the 

20 memory of the smart device. When the terminal is able to connect to a network, or to the 
Internet, storing the dictionary remote from the smart device reduces the memory 
requirements of the smart device. Additionally, remote storage of the dictionary allows 
additional dictionaries to be added to the boot file without having to download dictionaries to 
the smart device. Remote storage of the dictionary also allows the dictionary to be modified, 

25 should this deem desirable. Alternatively, storage of the dictionary on the smart device 

provides additional assurance that the dictionary has not been modified, especially when the 
dictionary is stored in write resistant memory. Storage of the dictionary on the smart device 
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allows access of the dictionary when the terminal is not able to access a network, or the 
Internet. In one embodiment of the present invention, a core set of dictionaries is stored on 
the card and an enhanced set of dictionaries is stored in a remote file. The core dictionaries 
support the basic functionality of a given card. The enhanced dictionaries provide support to 

5 additional features available for use withlhe cardriiTtKis manner'thecard provides basic 

support common with off-line applications, in addition to providing enhanced functionality 
common with on-line applications. 

~^At~step(52)~theiinking engine selects one of the dictionaries listed in the boot file.for^ ^ 
compatibility testing. At step (53) the linking engine retrieves the dictionary selected at step 

10 (52). At step (54) the linking runs the boot to scan the retrieved dictionary to retrieve 

selected segments of the dictionary for input to the linking engine for compatibility testing. 
The boot file provides a description of the segments of the dictionary to be scanned and used 
in generating the output value of the compatibility test. The linking engine generates an 
output value based on the specified dictionary information. At step (55) the linking engine 

1 5 receives the output value from the compatibility test. The output value is compared to a 
bootcheck value at step (56). In the preferred embodiment of the present invention the 
bootcheck value is a standard value common for all smart devices. The bootcheck value may 
be stored in the application logic unit, the boot file, or the dictionary. If the output value is 
the same as the bootcheck value the linking engine adds the dictionary corresponding to the 

20 output value to a list of compatible dictionaries at step (57). The linking engine then proceeds 
to step (58). If at step (56) the output value is not the same as the bootcheck value the linking 
engine proceeds to step (58) without adding the dictionary corresponding to the boot to the 
compatible dictionary list. 

Different applications and smart devices may require testing of multiple 

25 functionalities of the dictionary and the card. In such instances, there may be a plurality of 
bootcheck values corresponding to the multiple functionalities to be tested for compatibility. 
In the preferred embodiment of the present invention, the bootcheck value corresponding to 
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each functionality tested will be common for all smart devices. Optionally, the linking may 
generate a plurality of output values based on the boot file, the output values being dependent 
on the smart device. At step (55) the linking engine receives the output values from the 
compatibility test. The output values are compared to the corresponding bootcheck values at 

5 step (56). If the output valuFi^he~same1i^th^l^ 

functionality being tested the linking engine adds the dictionary corresponding to the output 
value to a list of compatible dictionaries at step (57). The linking engine then proceeds to 

" step (58). if at step (56) the output value is not-equal to the bootcheck value-the linking 

engine proceeds to step (58). 

10 At step (59) the lining engine checks whether all of the dictionaries listed in the boot 

file have been tested for compatibility. If all of the dictionaries have not been tested, the 
system returns to step (52). If all of the dictionaries have been tested, the linking engine 
proceeds to step (59). In the presently preferred embodiment of the present invention the 
linking engine tests all of the dictionaries and compares the output value form each dictionary 

1 5 against the bootcheck value. All the dictionaries having an output value equal to the 
bootcheck value are added to the list of compatible dictionaries. 

Optionally, the linking engine can compare the dictionaries on the list of compatible 
dictionaries to select which dictionary to specify as the application protocol. Selection could 
be based on the smallest file size of the dictionary, the most features of the dictionary, or 

20 some other criteria. Alternatively, as all of the dictionaries are suitable for use as the 

application protocol, the linking engine may select any of the dictionaries from the list at 
random. This selection process, by any suitable process, is performed at step (59). 

At step (60) the linking engine returns the identifier of the dictionary selected for use 
as the application protocol to the application logic unit. 

25 Figure 7 is flow chart illustrating the process of running an application in accordance 

with the present invention. At step (70) the application logic unit begins the process of 
creating a virtual smart device by creating a profile for the dictionary. At step (71 ) the 
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application logic unit establishes the linking engine to run on top of any software layer which 
interacts with the terminal hardware. In the preferred embodiment of the present invention 
the linking engine is stored on the terminal. Step (71) makes an initial call to the linking 
engine. At step (72) the virtual smart device is created as running on top of the terminal 

5 hardware layer of ^fhvareluMTefe^^ 

smart device allows the application logic unit to access the linking engine to link the 
application logic unit to an application protocol. 

At step (73) the application logic unit initiates a boot check to find-the dictionary to_be_ 
used as the application protocol. The boot check process is described in detail above in 

10 connection with Figure 6. The dictionary selected during the boot check process is returned 
at step (74) and is used as the application protocol. 

At step (75) the application logic unit invokes a method call. A method call can be 
any logical process to access or manipulate data on either the smart device or the terminal. 
Checking the balance in the card's electronic purse is one example of a method call. Another 

15 example of a method call is the debiting of loyalty points in a smart card. As described in 
connection with Figure 5, the linking engine receives the invoked method call at step (43) 
and uses the dictionary definition of the method in running the application. Based on the 
definition contained in the dictionary, at step (47) the linking engine runs a sequence of smart 
device commands. These commands output responses based on the data from the card and 

20 the dictionary. The linking engine returns the responses related to the smart device 

commands to the application logic unit at step (48) of Figure 5. The application logic unit 
receives the command output responses at step (76). The application logic unit then 
continues by either invoking additional method calls, in which the process begins again at 
step (75), or by ending. 

25 
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Example 

A source code example of an application logic unit and the appropriate dictionary 
used as the application protocol, in accordance with the present invention, is given below. 
The boot file for testing compatibility between a dictionary and the application logic unit is 
also provided. The example application logic unit is written in Java™ and the related 
application protocol and boot files are written in XML. In the presently preferred 
embodiment, XML is chosen for its suitability in providing descriptions of the hardware 
implementation. 

In the examples below the line numbers (Al , A2, A3, . . .; Bl ,B2~, B3, .7. ; CI , C2, 
C3,. . ..) are only used for discussion purposes and are not part of the source code. These line 
numbers refer only to the line as printed herein and not to a "line" of the source code. 

APPLICATION LOGIC UNIT 

The Java example below of an application logic unit is for a loyalty application, as 
indicated by line Al . This example of an application logic unit checks the loyalty points 
stored on the smart card, determines whether additional loyalty points are to be credited and 
added to the loyalty points total, and whether loyalty points are being redeemed and debited 
from the loyalty points total. At line A31 the string variable for the dictionary is created. 
The main part of the program begins at line A 190. A207- A21 5, A226 and A232-A233 a 
virtual smart card is created to access the linking engine. At line A207 the boot file is 
imported to the application as an argument. The boot argument is then used at line A21 1 in 
creating the profile instance of the smart card. At line A237-A238 the process of checking 
the boot find the appropriate dictionary is initiated. At lines A264 and A265 the dictionary 
determined to be the appropriate dictionary, as described above in connection with Figure 6, 
is used as the application protocol. Once the dictionary used as the application protocol is 
specified, the application logic unit is then free to implement the logic of the application 
using the hardware specific information and rules specified in the dictionary. Accordingly, at 
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line A288 the application begins the logic of implementing a loyalty application; The logic 
of implementing the loyalty application continues through to line A773. The logic of the 
application includes security check methods, balance check methods, methods to redeem and 
award loyalty points, as well as methods to report and collect information form the 
5 cardholder and the merchant sponsoring thel oyal ty program — 

For example, from line A288 through line A360 the application logic unit provides a 
security check procedure. 

Asan addi tidnaf example; the application logic unit readsthe value of-the transaction 
for crediting loyalty points to the cardholder from line A367 through line A375. The 
1 0 application logic unit prompts the entering of the amount of the transaction at lines A370- 
A372. The amount of the transaction is read at line A374. 

The example application logic unit contains four verbs: GetCardlnfo, verify, 
TransactionAward, and TransactionRedeem. 

The first method call for the verb GetCardlnfo is at line A4 1 0. The first method call 
1 5 for the verb verify is at line A657. The first method call for the verb TransactionAward is at 
line A533. The first method call for the verb TransactionRedeem is at line A576. The first 
method call for all four of the verbs used in the application logic unit are after the application 
logic unit has specified the dictionary to be used as the application protocol. In this manner 
the definitions of the verbs in the application protocol are linked to the method in the 
20 application logic unit prior to the invocation of the method call 



25 



30 



Al: 

A2: 

A3: 

A4: 

A5: 

A6: 

A7: 

A8: 

A9: 

A10: 

All: 

A12: 



package applications . loyalty; 

import applications . loyalty. crypto. J 

import com. gemplus . scidl . frameworks " 
import com . gemplus . scidl . util . * ; 
import com. gemplus. scidlx. framework. 

import java . awt . event . *; 

import java. util. Enumeration; 
import java. util .Calendar; 
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A13: import java . util . StringTokenizer ; 
A14: 

A15: public class Loyaltylnterf ace { 
A16: 

A17 : // class members 

A18: private static final String" welcome = 

A19: "\nWELCOME to the Loyalty application (c) Solves inc." + 

A20: "\nThis application manages a Loyalty program on two"+ 

A21 : "\nGemplu s smart cards : " + 

A22: "\n * G^Cllil5"rGem^lTJ^l7oyal-t7-^ardh ,, -+* 

A23: "\n * GemXplore (Gemplus GSM card)" + 

A24: "\riEach card interface has been described using SCIDL."+ 

A25: "\nThrough this interface, the same application can communicate" + 

A26: "\nwith multiple smart cards . "+ 

A27: "\n \nSource code and XML descriptions are available at : " + 

A28-: ^^\nhttp:A\^\gempJ L us^co^m^\\solves\\applications" + 

A29: "\n \n** PLEASE INTRODUCE YOUR CARD" TO" START" THE APPIrl CAT ION- *-* — 
A30: 

A31: String xml_f ilename; // this is the xml file to use 

A32: 7/ MODIFICATION FOR THE INTERFACE> 
A33: • //.PREVIOUS IMPLEMENTATION 

A34 : // RunProcess virtualCard // the virtual card instance 

A35: // NEW IMPLEMENTATION 

A36: RunProcess processEngine; // the process engine instance 

A37: // END OF MODIFICATION 

A38: int iAmount = 0; // the transaction amount 

A39: PosTerminal theTerminal; // the terminal instance 

A40: PosPinpad pinpad; // the terminal 1 s pinpad 

A41: Object [] responseProcess = null; // the process 1 responses 

A42: Argument [] arguments = null; // the Argument container 

A43: 

A44: long serialNumber = 0; // the card serial number 

A45: String cardHolderlnf o = ""; // the card user information 

A46: int lastTransactionDate = 0; ' // the last transaction date 

A47: String lastTransactionlnf o = ""; // the last transaction 

A48: int lastTransactionAmount = 0; // the last transaction amount 

A4 9: int cardBalance = 0; // the card balance 

A50: int transactionType = 0; // the transaction type 

A51: Calendar date; // the date instance 

A52: 

A53: int state = 0; // the state machine index 

A54: // MODIFICATION FOR THE INTERFACE> 

A55: VirtualCardlmpl virtualCard; // the virtual card 

A56: // END OF MODIFICATION 

A57: 

A58: // state machine index 

A59: public static final int NONE_STATE = 0; 

A60: public static final int AWARD_STATE = 1; 

A61: public static final int REDEEM_STATE = 2; 

A62: public static final int CHV_VERIFICATION = 4; 
A63: 

A64: public static final int AWARD_TRANSACTION = 1; 

A65: public static final int REDEEM_TRANSACTION = 2; 
A66: 

A67: /** 

A68: * Class contructor 

A69: 

A70: */ 
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A71 
A72 
A73 
A74 
A75 
A7 6 
A77 
A78 
A79 



A80 
A81 



public Loyaltylnterface <). { } 



// this is the class back implementation using the plugin interface 
Plugln plugin = new PluglnAdapter ( ) { 
private Argument [] theArguments •=» null; 
private Object!] r - null; 



_// 

//—+-* *-*-* -*-*-+-*■+ •*— rmpi-ement-the-ca 1-1 ba c k-me fc-hods— * aaaaa* * » * » » *** 



A82: public Object [] runCallback (Object [ ] _o, String ^message) { 

A83: // _o[l) returns the arguments of the process 

A84: // _o[0] returns the member holder of the process for th 

previous steps 
A85: 

// for debug only ~" ~ " 

MemberHolder memberHolder = (MemberHolder) _o[0]; 
System, out .println{ "this is the list of member" + memberHolder); 
for (Enumeration localMembers = memberHolder .getMemberList () ; 
localMembers . hasMoreElements ( ) ; ) 
System. out .println ("this is the member found in the callback: 



A86 
A87 
A88 
A89 
A90 
A91 
+ 

A92 

A93 

A94 

A95 

A96 

A97 

A98 

A99 

A100 

A101 

A102 

A103 

A104 

A105 

A106 

A107 

A108 

A109 

A110 

Alll 

A112 

A113 

A114 

A115 

A116 

A117 

A118 

A119 

A120 

A121 

A122 

A123 

A124 

A125 

A126 



// end of debug 



( (Member) localMembers . nextElement ( ) ) .getName ( ) ) ; 



// this is the call back to get the related XML file according 
//to the smart card inserted in the reader 
if {_message.substring(0, 5) .equals ("file: ") ) { 

runApplication (^message) ; 

r = _o; } 

// this is the certificate process callback from the XML 
else if (^message. substring (0, 6) . equals { "crypto" ) ) { 
theArguments = runTransactionCertif icate (_o, ^message) ;. 
r = _o; } 

// this is the balance management callback from the XML 
else if (_message. substring (0, 12) . equals ( "awardBalance" ) ) { 

NotSecuredPurse localPurse = NotSecuredPurse . get Instance () ; 

MemberHolder outMembers = (MemberHolder ) . _o [ 0] ; 
Object [] arguments = (Object []) _o{l]; 

// here we can use reflexion 

localPurse. setBalance (outMembers, cardBalance) ; 

MemberHolder responseArgs = localPurse. award (outMembers, 
iAmount ) ; 

Object [] pluglnArgs = new Object [2]; 
pluglnArgs [0] = responseArgs; 
pluglnArgs [1] = arguments; 

r = pluglnArgs; ) 

else if (_message . substring (0, 13) . equals ( "redeemBalance" ) ) { 

NotSecuredPurse localPurse = NotSecuredPurse. get Instance () ; 
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MemberHolder outMembers - (MemberHolder) 
Object [] arguments = (Object []) _o[l]; 



A127 
A128 
A129 
A130 
A131 
A132 
A133 

A134: MemberHolder responseArgs 

A135iAmount: ) ; 

tA-1-36: 



o[0]; 



// here we can use reflexion instead 
localPurse.setBalance (outMembers, cardBalance) ; 



localPurse. redeem (outMembers, 



Object [] pluglnArgs - new Object [2]; 
pluglnArgs [0] = responseArgs; 
pluglnArgs [1] = arguments; 



r 

return 



■ pluglnArgs; 
r; } 



} 



*********** Implement the plug in controls +++++++*★+**+*** 



A137 
A138 
A139 
A140 
A141 
A142 
"Al'43 
A144 
A145 
A14 6 
A147 
A148 
A149 
A150 
A151 
A152 
A153 
A154 
A155 
A156 
A157 

localMembers . nextElement ( ) ) . getName ( ) ) ; 



t ★ + ★ * ★ 4 



k + ★ + * 



// 
// 
// 

public ResponseApdu runPlugln (Obj ect [ ] _o, String _message) { 
// _o[l] returns the arguments of the process 
// _o[0] returns the member holder of the previous steps 

// for debug only 

System. out. println ( "this is the list of member"); 
MemberHolder memberHolder = (MemberHolder) _o[0]; 
for (Enumeration localMembers = memberHolder . getMemberList () ; 
localMembers . hasMoreElements ( ) ; ) 
System- out .println ( "this is the member found in the plugin: 
( (Member) 



A158 
A159 
A160 
A161 
A162 
A163 
A164 
A165 
A166 
A167 
A168 
A169 
{ 

A170: 
A171: 
+ 

A172 
A173 
A174 
A175 
pinpad 
A176 
A177 
A178 
A179 
A180 



/ / end of debug 
/ / get the content message 

StringTokenizer st = new StringTokenizer (^message, "?"); 
String messageld = st . nextToken ( ) . trim ( ) ; 

String message = st . nextToken (). trim () ; 
st = new StringTokenizer (message, "="); 
String itemName = st .nextToken (). trim( ) ; 
String itemValue - st . nextToken (). trim (} ; 

if (messageld. equals ( "pluginMessage" ) && itemName . equals ( "secretCode" ) ) 

theTerminal . displayMessage ( "ACCESS PROTECTED" + 

"\n \nThe user password is required to start the application." 



"\nCould you enter your password using the keypad" + 
"\n and press Valid key for verification."); 
|= CHV VERIFICATION ; 

// start reading message from the 



state 

pinpad . readMessage ( ) ; 



while ((state & 0x04) != 0) 
try { Thread. sleep(1000) j 
catch (Exception e) { } } 
passwork is completed 



i 

} // this wait till the present 
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A181: return null; } 

A182: }; , 
A183: 
A184: 

5 A185: /** 

A186: * main class 
A187: 

A188: * Gparam _args An array of strings to get the application 
parameters 

10 — -A-l-8 9 :— V : , 

A190: public static void main (String [ ] .args) { 

A191 : Loyaltylnterf ace application = new Loyaltylnterf ace () ; 

A192: application. start (args) ; 

A193: ) . 
15 A194: 
A195: 

A197: * The method to run the application 

A198: * 

20 A199: */ 

A200: private void start (String [ ] args) { 

A201: date = Calendar . getlnstance () ; 

A202: pinpad = new PosPinpad (this . listener ()) ; 

A203: theTerminal - new PosTerminal (pinpad) ; 

25 A204: theTerminal . displayMessage (welcome) ; 

A205: 

A206: // create the virtual smart card to access the engine 

A207: xral_filename = "file:////" + args[0]; 

A208: System. out .println ( "This is the XML file open: " + xml_f ilename) ; 

30 A209: // create the profile instance that contains all the smart card 
A210:profiles 

A211: Profilelmpl theProfiles = new Prof ilelmpl (xml_f ilename) ; 

A212: // get the content of the xml file 

A213: // note ** the next version of the engine should remove that 
35 . invocation 

A214 : . theProfiles. set Profiles ( ) ; 

A215: Enumeration prof ileList = theProf iles . getProf iles ( ) ; 
A216: 

A217: // create the process helper for the call back 

40 A218: CallBackList callbackList = new CallBackList ( ) ; 

A219: callbackList. addCallback (plugln) ; 

A220: // create the process helper for the plugln 

A221: PluginList pluginList = new PluginList ( ) ; 

A222: pluginList .addPlugin (plugln) ; 
• 45 A223: 
A224: 

A225: // create the process helper OCF 1.1 

.A226: Terminal OcfLayer = new Ocf Terminalll ( ) ; 

A227: // MODIFICATION FOR THE INTERFACE> 

50 A228: // PREVIOUS IMPLEMENTATION 

A229: // virtualCard = new RunProcessImpl (OcfLayer, pluginList, 

A230: callbackList) ; 

A231: // NEW IMPLEMENTATION 

A232: processEngine = new RunProcessImpl (OcfLayer, pluginList, 
55 callbackList); 

A233: virtualCard «' new VirtualCardlmpl (processEngine, theProfiles); 

A234: // END OF MODIFICATION 

A235: 
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A236 

A237 

A238 

A239 

A24 0 

A241 

A242 

A243 

A244 

A24-5- 

A24 6 

A247 

A248 

A24 9 

A250 

A251 

A252 

A253 

A254 

A255 

file 

A256: 

A257: 

A258: 

A259: 

A260: 

A261: 

A262: 

A263: 

A264 : 

A265: 

A266: 

A267: 

A268: 

A269: 

A270: 

A271: 

A272: 

A273: 

A274 : 

A275: 

A27 6: 

A277: 

A278: 

A279: 

A280: 

A281: 

A282: 

A283: 

A28 4 : 

from 

A285: 

A286: 

A287; 

A288: 

A289: 

A290: 

A291: 



// get the full file name of the application SCIDL file 
try { responseProcess = virtualCard. runProcess ( "getFile", arguments, 

theProfiles) ; } 

catch (Prof ileException pe) { 

theTerminal .displayMessage ( "The system has detected a problem." + 

"\nError message: " + pe . getMessage ( ) + 
"\n \nPlease, contact your service ' provider .") ; } 
catch (RunProcessException rpe) { 

theTermi-na-l~d-i-splayMessaqe (— The-.runtime-.environment_has_ dete cted a 

problem." + 

"\nError message: " + rpe . getMessage ( ) 
"\n \nPlease, contact your service provider."); } 



* The application implementation 

* @param _file A string that represents the full path of the XML 

* to use as the application protocol 

* Greturn An array of argument that may be null becaus the engine 
doesn't 

* expect any response 
*/ 

private void runApplication (String _file) { 
// set te new framework 

Profilelmpl theProfiles = new Prof ilelmpl (_f ile) ; 
theProfiles . setProfiles () ; 

// there is only one description in the XML. file 
CardProfile profile = 

(CardProfile) theProfiles. getProfiles ( ) .nextElement ( ) ; 
// MODIFICATION- FOR THE ' INTERFACE> 
// PREVIOUS IMPLEMENTATION 
// virtualCard. setProf ile (profile) ; 
// NEW IMPLEMENTATION 
processEngine.setProfile (profile) ; 
// END OF MODIFICATION 

runDisplay ( ) ; 
) 

/*■* 

* The method runs the generation certification for the given 

* smart card inserted in the reader 

■ + i 

* @param ^message A String that represents the message received 

* the XML file during the call back event. 

* @return An array of arguments that represents the data process 
*/ 

public Arguments runTransactionCertif icate (Object [ ] _o, String 
_message) { 
Argument [] arguments = null; 
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A292: 
A293: 
A294: 
A295: 
A296: 
A297: 
A298: 



// get 
// the 

StringTokenizer st = new 
String algo = st . nextToken { ) . trim ( ) 



the algorithm by checking the message (^message) 
message content has the form of: "crypto?award=DES' 
StringTokenizer (jnessage, M =") ; 



if (algo.equals("DES") ) { 
arguments = (Argument []) 
received A299:from the callback 
A300: int iTransaction = 0; 

"10 A301": byte [-]-baTransactibn-= 

A302: { 'P\ 'i', »z\ 'z', 'a' 



o[l], 



algo = st .nextToken (). trim () , 



// get the arguments 
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• A303 
A304 
A305 
A306 
A307 
A308 
A309 
A310 
A311 
A312 
A313 
A314 
A315 
A3 16 
A317 
A3 18 
A319 
0x08 
A321 
.0x18 
A323 
A324 
A325 
A326 
A327 
A328 
A329 
A330 
A331 
A332 
A333 
A334 
A335 
A336 
-A337 
A338 
A339 
A340 
A341 
A342 
A343 
A34 4 
A345 
A346 
A347 
A348 
A34 9 



i i i » » i . 

' ' J * 

byte[] baCertif icate = new byte [8]; 
Argument transactionAtt = null; 

//"get the transact i~on~argument ~ — — — - 
for (int i = 0; i < arguments . length; i++) { 

if (arguments [i] .getName () .equals ("transaction* 
transactionAtt = arguments [i] ; 
iTransaction = i; } } 



)) ( 



DES de.sAlgorithm = new DES(), 



// 
// 

// The 
byte[] 
A320: } ; 

byte[] 
A322}; 

DesKey 
DesKey 



both key are iitialized with zero 
implementation because the system 

next version of the implemention 
baAwardKey = { 0x01, 0x02, 0x03, 



value, this is for the initial 
doesn't support crypto 
will carry real keys 
0x04, 0x05, 0x06, 0x07, 



baRedeemKey = { 0x11, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17, 

awardKey = new DesKey (baAwardKey) ; 
redeemKey = new DesKey (baRedeemKey) ; 



// create the certification data in 



baCertif icate [0] = (byte) 

baCertif icate [1] = (byte) 

baCertif icate [2) - (byte) 

baCertificate [3] = (byte) 

baCertificate[4J = , (byte) 

baCertif icate [5] = (byte) 

baCertif icate [6] = (byte) 

baCertificate [7] = (byte) 



. YEAR) ■ 
.MONTH) 



1900) ; 

+ i); 



(date. get (Calendar 
(date. get (Calendar 
date . get (Calendar . DAY_OF_MONTH ) 
date. get (Calendar . HOUR_OF_DAY) ; 
date. get (Calendar . MINUTE) ; 
Hex. integerToBytes (iAmount) [1]'; 
Hex.integerToBytes (iAmount) [2]; 
Hex. integerToBytes (iAmount ) [3]; 



* if (state == AWARD_STATE) { 
try { 

desAlgorithm. set key (awardKey . getKey { ) ) ; 
desAlgorithm. encrypt (baCertificate) ; 
System. arraycopy (baCertif icate, 0, baTransaction, 
catch (CryptoException e) { 

System, out .print In ("this is CryptoException : " + 
e .getMessage ( ) ) ; } 

Variable transaction = ( (Variable) 
arguments [iTransaction] . getMember ( ) ) ; 

transaction. setValue (baTransaction) ; } 



8, 8); } 



if ( state 
try { 



REDEEM STATE) { 
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A350 
A351 
A352 
A353 
A354 
A355 
A356 
A356 
A357 
A3 5 8 
A359 
A360 
A361 
A362 
A363 
A364 
"A3 65 
A366 
A3 6 7 
A368 
A369 
A370 
A371 



desAlgorithm. set key (redeemKey. get Key () ) ; 
desAlgorithm. encrypt (baCertificate) ; 
System. arraycopy (baCertif icate, 0, baTransaction, 
catch (CryptoException e) { 

System. out .println ("this is CryptoException: " '+ 
e .getMessage ( ) ) ; } 

Variable transaction = ({Variable) 
arguments [ iTransaction] .getMember ( ) ) ; 

transaction. setValue (baTransaction) ; } } 



8/8); } 



return arguments ; 



} 



The method runs the award transaction 



public void runAwardO { 



if (state == NONE_STATE) { 

theTerminal . displayMessage { "AWARD TRANSACTION "+ 

"\n \nEnter the transaction amount using the 
keypad "+ 



A372 
A373 
A374 
A375 
A376 
A377 
. A378 
A379 
A380 
A381 
A382 
A383 
A384 
A385 
A386 
A387 
A388 
A389 
A390 
A391 
A392 
A393 
A394 
A395 
A396 
A397 
A398 
user 
A399 
A400 
A401 
A402 
A403 
A404 



} 



"\nand. press Valid key for confirmation."); 
AWARD STATE ; 

} // start reading message from the pinpad 



state 

pinpad. readMessage () ; 



The method runs the redeem transaction 



public void runRedeem() { 
if (state ~ NONE_STATE) { 

theTerminal . displayMessage ( "REDEEM TRANSACTION "+ 

"\n \nEnter the transaction amount using the keypad"+ 
"\nand press Valid key for confirmation.") 



state = REDEEM_STATE; 
pinpad . readMessage ( ) ; 



} 



} // start reading message from the pinpad 



The method runs the redeem transaction 



{ 



public void runCancel ( ) 
state - NONETS TATE; 

theTerminal. displayMessage ("ABORTED TRANSACT I ON " + 

"\n \nThe transaction process has been aborted by the 

'); 
} 



The method runs the redeem transaction 
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A405: */ 

A4 05: public void runDisplayO { 
A407: Argument [] nullArgument = null; ■ 
A408: 

A409: // get the card information 

A410: try { responseProcess = virtualCard . GetCardlnfo (nullArgument ) ; } 
A411: // MODIFICATION 'FOR THE INTERFACE> 
A412: // PREVIOUS IMPLEMENTATION 

A413: // responseProcess = virtualCard. runProcess ( "GetCardlnfo" , 
~A4T4 nuTl Argument ) ; 



A415: // Note for the developer: The previous implementation remains valid 
A416:because the 

A417: // converter creates the relevant method to wrap this invocation. It 
is A418: worth noticing 

A419: // this manner of invoking the smart card process becomes depreciated 
A420_:when using the 

A421: // inter~fa~ce "implementation "provided _ by~ the Converter^ 

A422: // 

A4 23: // The rest of the implementation remains depreciated and doesn't use 
A424:the method 

A425: // invocation on purpose^ The target of this implementation is to 
A426:measure the 

A427: //correction to bring in the loyalty. java file to move from one 

A428 : implementation to 

A429: // the stub implementation. 

A430: 

A431: catch (Prof ileException pe) { 

A4 32: theTerminal. displayMessage ("The system has detected a problem." + 
A433: "\nError message: " + pe . getMessage ( ) + 

A4 34: "\n \nPlease, contact your service provider."); ) 

A435: catch (RunProcessException rpe) { 

A436: theTerminal. displayMessage ("The runtime environment has detected a 
A437 : problem. " + 

A438: "\nError message: " + rpe .getMessage ( ) + 

A439: "\n \nPlease, contact your service provider. ") ; ) 

A440: 

A4 41: 

A442: serialNumber = ((Variable) f indMember ( "CardSerialNumber ", 
A443: responseProcess) ) . tolnteger () ; 

A444 : 

A445: cardHolderlnfo = ((Variable) f indMember ( "CardHolderName" , 
A44 6: responseProcess) ) . toString ( ) ; 

A447: cardHolderlnfo. trim( ) ; 
A448: 

A449: lastTransactionlnfo = ((Variable) f indMember ( "LastTransactionlnf o" , . 
A450: responseProcess) ) . toString ( ) ; 

A451: 

A452: lastTransactionAmount = ( (Variable) 
f indMember ( "LastTransactionAmount", 

A453 responseProcess) ). tolnteger () ; 

A454: 

A455: lastTransactionDate = { (Variable) f indMember ( "LastTransactionDate" , 
A456: responseProcess) ) .tolnteger ( ) ; 

A457: 

A458: cardBalance = ((Variable) f indMember ( "cardBalance", 

A459: responseProcess) ) .tolnteger () ; 

A4 60: 

A461: transactionType = ((Variable) .f indMember ( "transactionType", 

/• 
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A4 62: responseProcess) ) ..tolnteger () ; 
A463: 

. A464: if (transactionType == 1 ) { 

A4 65: theTerminal . displayMessage ( "Welcome to Solves E-commerce server." + 

A4 66: "\n \nSmart card ID: " + serialNumber + 

A4 67: v "\nUsername: " + cardHolderlnf o + 

A468: "\n \nThis is your account information..." + 

A469: "\nLast award transaction: " + lastTransactionlnf o 
+ 

A470: "VnDate:-"— h 

A471: (byte) (lastTransactionDate) + "-" + 

A472: (byte) {lastTransactionDate » 8) + "-" + 

A473: (byte) (lastTransactionDate » 16) + 

A474 : "\nAmount: " + lastTransactionAmount "+ 

A475: "\n \nYour current balance is: " + cardBalance + 

. A476_: _ _" point js)_") ; } 

A477: else if (transactionType == 2)~ { — 

A4 78: theTerminal . displayMessage ("Welcome to Solves E-commerce 
A479: server . " + 

A480: "\n \nSmart card ID: " + serialNumber + 

A4 81: "\nUsername: •" + cardHolderlnf o + 

A482: "\n \nThis is your account information..:" + 

A483: "\nLast redeem transaction: " + lastTransactionlnf o 

+ 

A484: "\nDate: " + 

A485: , (byte) (lastTransactionDate) . + "-" + 

A486. (byte) (lastTransactionDate 8) + "-" + 

A487: (byte) (lastTransactionDate » 16) + 

A488: "\nAmount: " + lastTransactionAmount + 

A489: "\n\nYour current balance is: " + cardBalance + 

A490: " point (s) ") ; } 

A491: else { 

A492: System. out .println ( "This is the card holder name: " + 
A4 93:cardHolderInfo) ; 

A4 94: theTerminal . displayMessage ( "Welcome to Solves E-commerce server." + 

A4 95: "\n \nSmart card ID: " + serialNumber + 

A496: "\nUsername: " + cardHolderlnf o + 

A4 97: "\n \nYour current balance is: " + cardBalance + 

A498: " point (s) M ); ) 

A4 99: 

A500: } 

A501: 

A502: 

A503: /** 

A504 : * The method runs the redeem transaction 

A'505: 

A506: */ 

A507: public void runBonus { ) { 

A508: System. out .println { "TerminalPinPad this is the key press: bonus"); 
A509: 

A510: // set the transaction date 

A511: byte[) baDate = { (byte) (date . get (Calendar . YEAR) - 1900), 

A512: (byte) (date . get (Calendar . MONTH) + .1) , 

A513: (byte) da te. get (Calendar .DA Y_OF_MONTH) }; 
A514: 

A515: if (state == AWARD_STATE) { 
A516:// start the transaction processing 
A517:// 1 - update the amount to increase 
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A518 
A519 
A520 
A521 
A522 
A523 
A524 
A525 
A526 



byte[] baAmount = new byte [3]; 

iAmount = Integer . parselnt (the Terminal . getMessage ( )) ; 
baAmount[0] = Hex . integerToBytes (iAmount ) [ 1 ] ; 

baAmountfl] = Hex .integerToBytes (iAmount ) f 2] ; 

baAmount[2] = Hex . integerToBytes ( iAmount )[ 3] ; 



A527 
A528 
A529 
A530 
A531 
A532 
__A533 
A534 
A535 
A536 
A537 
A538 
A539 
A540 
a A54 
A542 
A543 
A54 4 
A545 
A54 6 
A54 7 
A548 
A54 9 

A550 
A551 
A552 
A553 
A554 
A555 
A556 
A557 
A558 
A559 
A560 
A561 
A562 
A563 
A564 
A565 
A566 
A567 
A568 
A569 
A570 
A571 
A572 
A573 
A574 



// 2 - prepare the transaction 
Argument amount Att = new Argument ( "amount 1 



baAmount ) ; 



Argu7nent~dat~eAt~t~=~new- Argument-<"dat e "~ baDa -fee )-;- 
byte[] tid = new byte [16]; 

Argument terminalld = new Argument ( "transaction", tid) ; 
Argument [] awardArguments = { amountAtt, dateAtt, terminalld }; 

// 3 - run the transaction 
-£. r .y__ {^response Process = virtualCard. runProcess ( "Transact ionAward", 

~ "awardArguments ) ; -J — 

catch (Prof ileException pe). { 

theTerminal . displayMessage ("The system has detected a problem.". 
"\nError message: " + pe. getMessage ( ) + 
"\n \nPlease, contact your service povider."); ) 
catch (RunProcessException rpe) { 

theTerminal. displayMessage ("The runtime environment has detected 
1: problem." + 

"\nError message: " + rpe . getMessage ( ) + 
"\n \nPlease, contact your service provider."); } 

int newBalance = ((Variable) f indMember ( "newBalance", 

responseProcess ) ) . tolnteger ( ) ; 
System. out . println ( "This is the new balance... : " + newBalance); 
theTerminal. displayMessage ("PROCESSING AWARD TRANSACTION..." + 

"\n \nThe number of point (s) to award was: ' 

theTerminal. getMessage () + 
"\n \nAward transaction successful . " + 
"\nThe new balance of the card is: " + 
newBalance) ; 

// stop the state machine 



state = NONETS TATE; } 
if (state REDEEM STATE) 



{ 



// start the transaction processing 
// 1 update the amount to redeem 
byte[] baAmount = new byte [3]; 

iAmount = Integer . parselnt ( theTerminal . getMessage ()) ; 
baAmount[0] = Hex. integerToBytes (iAmount ) [1] , 
baAmount[lJ = Hex. integerToBytes (iAmount ) [2] . 
baAmount[2] « Hex . integerToBytes (iAmount ) [3] , 

System. out .println ( "this is the redeem bonus press") ; 

111- prepare the transaction 

Argument amountAtt ~ new Argument ( "amount ", baAmount); 
Argument dateAtt = new Argument ( "date" , baDate) ; 
byte[] tid = new byte [16]; 

Argument terminalld = new Argument ( "transaction", tid) ; 
Argument [] awardArguments = { amountAtt, dateAtt, terminalld }; 



-24- 



WO 00/75775 



PCT/US00/15689 



10 



15 



20 



25 



30 



35 



40 



45 



50 



55 



A575 
A576 
A577 



A579 
A580 
A581 
A582 
-A5.8.3. 
A584 
a A585: 
A586 
A587 
A588 
A589 
A590 
A591 
A592 
A593 
A594 
A595 
A596 
A597 
A599 
A600 
A601 
A602 
A603 
A604 
A605 
A606 
A607 
A608 
A609 
A610 
A611: 
pinpad 
A612 
A613 
A614 
+ 

A615 
A616 
A617 
A618 
pinpad 
A619 
A620 
A621 
A622 
A623 
A624. 
A625 
pinpad 
A626 
A627 
A628 
A629 



try { responseProcess - virtualCard. runProcess ( "TransactionRedeem", 

A578 : awardArguments) ; } 
catch (Prof ileException pe) { 

theTerminal. displayMessage ("The system has detected a problem." + 
"\nError message: " + pe . getMessage ( ) + 
"\n \nPlease, contact your service provider."); } 
_ca_t ch (Run P rocessE xception rpe) { 

theTerminal . displayMessageT"Th~e — runtime ^environment— ha-s-de-t.ect.ed_ 
problem." + 

"\nError message: " + rpe . getMessage ( ) + 
"\ri \nPlease, contact your service provider."); } 

int newBalance = ( (Variable) f indMember ( "newBalance", 

- - - ResponseProcess) ) . tolnteger ( ) ;. 

System. out .println ("This is the new balance": ~+~newBa"Ia nee) -; 

theTerminal. displayMessage ("PROCESSING REDEEM TRANSACTION..." +' 
"\n \nThe number of point (s) to redeem was: " + 
theTerminal. getMessage () + 
"\n \nRedeem transaction successful." + 
"\nThe new balance of the card is: " + 
newBalance) ; 

state = NONE_STATE; } // stop the state machine 

} 



/** 

* The method runs the redeem transaction 



public void runValid() { 

f (state == A WAR D_S TAT E ) { 
pinpad. readMessage ( ) ; 



// stop reading the message from 



theTerminal. displayMessage ("PROCESSING AWARD TRANSACTION..." + 

"\n \nThe transaction amount is: " + 
theTerminal .getMessage ( ) + " point (s)" 

. "\n \nPlease press Bonus key to confirm or Cancel to abort."); } 



f(s ( tate *- REDEEM_STATE) { 
pinpad. readMessage ( ) ; 



// stop reading the message from 



theTerminal. displayMessage ("PROCESSING REDEEM TRANSACTION..." + 
"\n \nThe transaction amount is: " + 
theTerminal . getMessage ( ) + " point (s) " + 
"\n \nPlease press Bonus key to confirm or Cancel to abort."); ) 

f( (state & 0x04) == CHV_VERIFICATION) { 
pinpad. readMessage () ; // stop reading the message from 

theTerminal. displayMessage ("PASSWORD VERIFICATION. . . . " + 

"\n \nPassword entered by user:" + theTerminal . getMessage ()) ; 

// real present the related password 
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A630 
A631 
A632 
A634 
A635 
A636 
A637 
A638 
A639 
A640 
A641 
A64 2 
A64 3 
A64 4 
A645 
A646 
A647 
A64 8 



byte[] baValuex = new byte [8]; 

String pincodeLiteral = theTerminal . getMessage ( ) ; 

char[] raessageReceived = pincodeLiteral . toCharArray () ; 

byte [J baMessageReceived - new byte [messageReceived . length] ; 



for(int i = 0; i < messageReceived .length; i++) 
from char to byte 

baMessageReceived [i] = (byte) messageReceived [i ] ; 



// conversion 



for{int—i-=-0;-i—<-baVa-luex— length-;— i-++-)— 
default value 

baValuex[i] = (byte) Oxff; . 

System. arraycopy (baMessageReceived, 0, 
password buffer 

'baValuex, 0, messageReceived . length) ; 



-/-/—set- -the 



.// update the 



// feak 

•4\ (byte) Oxff, (byte) Oxff, (byte) Oxff, (byte) 



byte [] ba Value = 
presentation 
A64 9: { '1\ % 2\ '3', 
A650: Oxff }; 
A651: 

A652: Argument value = new Argument ( "value", baValue) ; // change baValue 
A653:by baValuex here , 

A654: Argument index » new Argument { "index" , (byte) lj'; // to use the 
real A655 rpresentation 



A656 
A657 
A658 
A659 
A660 
A661 
A662 
A663 
A664 
A665 



Argument!] chvArguments = { value, index }; 
try { responseProcess = virtualCard. runProcess ( "verify" , 
chvArguments); } 



catch (Prof ileException pe) { 

theTerminal. displayMessage ("The system has detected a problem." + 

"\nError message: " + pe . getMessage ( ) + 
"\n \nPlease, contact your service provider."); ) 
catch (RunProcessException rpe) { 

theTerminal .displayMessage ("The runtime environment has detected 
a A666 : problem. " + 

A667: "\nError message: " + rpe . getMessage ( ) + 

"\n \nPlease, contact your service provider."); } 



A668 
A669 
A670 
A671 
A672 
} 

A673 
A674 
A675 
A676 
A677 
A678 
A679 
A680 
A681 
A682 
A683 
A684 
A685 
A686 



state = state & OxFB; // reset the present password state 

machine 

System. out .println ("this is the state machine invalid: " + state); 

} 



// Create the generic control listeners *** 

// *★★* + * + * * + + * + * + + * + + ★ + + * + * + + 

final ActionListener listener () { 
ActionListener theListener = new ActionListener ( ) { 
public void. actionPerf ormed (ActionEvent _e) { 

PosButton button = (PosButton) _e . getSource ( ) ; 
if (button. getText () . equals { "award" ) ) runAwardO ; 
if ( button /getText () .equals ("valid") ) runValidO ; 
if ( button. getText () . equals ("display" ) ) runDisplay ( 
if (button. getText () .equals ("bonus") ) runBonus ( ) ; 



+*++*++ 

+ ★*★★*•* 
******* 



); 
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A687 
A687 
A688 
A689 
A690 
A691 
A692 
A693 
— related 
A695: 
A696: . * 
responses 
A697: 
A698 
A699 
-A7G0 
A701 



if (button. getText ().. equals ( "cancel") ) runCancel ( } 
if (button .getText ( ) .equals ( "redeem") ) runRedeem{ ) 
return theListener; 
} 



} ); 



/ + ★ 

* The method 
A6 9A mem ber 



looks up in the response members and returns the 



@param _member A string that represents the member in the 



* ^return A member instance that represents the member found in the 
response list, 

+ otherwise the method reutrns null 

private Member 



{ 

A702: 
A703: 
A704 : 
A705: 
A706: 
A707: 
A707: 
A708: 
A709: 
A710: 
A711: 
A712: 
A713: 
A714 : 
A715 
A716: 

A717 : class 
A718: 



findMember (String _member, Objectt] _responseProcess ) 



Object [) localResponses = _responseProcess; 
Member foundMember = null; 



for (int i = 0; 
ResponseApdu 



i < localResponses. length; i++) { 

ra = (ResponseApdu) localResponses [i] 



MemberHolder responseMembers ■» ra . getResponseMembers ( ) 
Enumeration members = .responseMembers . getMemberList () ; 
while (members . hasMoreElements ( ) ) { 

Member member = (Member) members . nextElement () ; 
if (member .getName () .equals (^member) ) 
foundMember = member; } } 
return foundMember; 
) 



} 



NotSecuredPurse ( 



A719: 
A720: 
A721: 
A722: 
A723: 
A724 : 
A725: 
A726: 
A727: 
A728: 
A72 9: 
A730: 
A731: 
A7 32: 
A733: 
A734: 
A735: 
A736: 
hi 31: 
A7 38: 
A739: 
A74 0: 



public void NotSecuredPurse ( ) { } 

private static NotSecuredPurse localPurse = null; 

private int iBalance; 

private boolean zBalance = false; 



public MemberHolder award (MemberHolder 
MemberHolder localMember = o; 



o, int iAmount) { 



Member newBalance = localMember . getMember ( "newBalance" ) , 
iBalance += _iAmount; 
byte[) baAmount = new byte [3]; 
baAmount[0] = Hex . integerToBytes (iBalance) [ 1] 
baAmount[l] = Hex . integerToBytes (iBalance) [2] , 
baAmount[2] = Hex . integerToBytes (iBalance) [3] , 
( (Variable) newBalance) .setValue (baAmount) ; 
return localMember; } 



public MemberHolder redeem (MemberHolder 
MemberHolder localMember « o; 



o, int iAmount) { 



Member newBalance = localMember .getMember ( "newBalance" ) 
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A741 
A742 
A743 
A74 4 
A745 
A746 
A747 
A748 
-A7_4.9 
A750 
A75.1 
A752 
A753 
A754 
A755 
-A7-56 
A7 57 
A758 
A759 
A760 
A761 
A762 
A763 
A763 
A765 
A766 
A767 
A768 
A769 
A770 
A771 
A772 
A773 



iBalance -= __iAmount; 
byte[] baAmount = new byte[3]; 
baAmountfO] = Hex . integerToBytes (iBalance) [ 1 ] 
baAmount[l] = Hex. integerToBytes (iBalance) [2] 
baAmount[2] = Hex . integerToBytes (iBalance) [ 3] 
((Variable) newBalance) . setValue (baAmount ) ; 
return localMember; } 

public void_j; et Balance (MemberHolder _o, int _iBalance) { 
if (! zBalance) { , ' " 

"IBalance = iBalance; 



MemberHolder localMemberHolder 



o; 



if (localMemberHolder . isInMemberList ("newBalance") ) { 

Member newBalance 1 oca lMember Holder . getMember r 1 newBalance" ) ; 

byte[] baAmount = new byte [3]; " " ~ ~ 

baAmount[0) = Hex. integerToBytes (iBalance) [ 1] 

baAmountfl] = Hex. integerToBytes (iBalance) [2] 

baAmount [2] = Hex . integerToBytes (iBalance) [3] 

( (Variable ) newBalance ) . setValue (baAmount ) ; } 
zBalance = true; } 



} 



public int getBalanceO { return iBalance; } 

public static .NotSecuredPurse getlnstance ( ) { 
if (localPurse == null) 

localPurse = new NotSecuredPurse () ; 

return localPurse; 
} 



APPLICATION PROTCOL 

The example of an application protocol listed below from line Bl through B803 
provides the data and rules for implementing the logic of the application logic unit listed 
40 above on a Gemplus™ GemXplore98™ smart card. The card the dictionary is compatible 
with is specified at line B6. This example dictionary includes definitions on four verbs: 
GetCardlnfo, verily, TransactionAward, and TransactionRedeem. 

At line B10 the verb GetCardlnfo is specified. The two method calls for the verb 
GetCardlnfo in the example of the application logic unit, described above, are at lines A410 
45 and A413. The definition of the verb GetCardlnfo is provided at lines Bl 1 through B293. 
Lines Bl 5 through B57 list data for the implementation of the verb GetCardlnfo. Lines B59 
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through B293 list the rules used in implementing the verb GetCardlnfo on the Gemplus 
GemXplore98 smart card. 

At line B295 the verb verify is specified. The definition corresponding to the verb 
verify is provided at lines B295 through B326. Lines B296 through B302 list data for the 
5 implementation of the verb verify. Lines B303 ^ughB326Tist The rules usedln ~~ 
implementing the verb verify on the Gemplus GemXplore98 smart card. The only method 
call for the verb verify in the above example of an application logic unit is at line A657. 

. ~ At line B328 the" verb TransactionAwardis specifiedrThe definition of the verb - 
TransactionAward is provided at lines B328 through B554. Lines B332 through B377 list 

10 data for the implementation of the verb TransactionAward. Lines B379 through B554 list the 
rules used in implementing the verb TransactionAward on the Gemplus GemXplore98 smart 
card. The only method call for the verb TransactionAward in the above example of an 
application logic unit is at line A533. 

At line B555 the verb TransactionRedeem is specified. The definition of the verb 

15 TransactionRedeem is provided at lines B555 through B785. Lines B559 through B595 list 
data for the implementation of the verb TransactionRedeem. Lines B597 through B803 list 
the rules used in implementing the verb TransactionRedeem on the Gemplus GemXplore98 
smart card. Lines B597 through B785 list the rules used in implementing the verb 
TransactionRedeem on the Gemplus GemXplore98 smart card. The only method call for the 

20 verb TransactionRedeem in the above example of an application logic unit is at line A576. 

In the definitions of the four verbs contained in the application protocol, the data and 
rules used to implement the definition of the verb is particular to the smart device, in this 
example a Gemplus GemXplore98 smart card. Definitions for the same four verbs: 
GetCardlnfo, verify, TransactionAward, and TransactionRedeem, for implementation with 

25 another smart device in connection with the example application logic unit would typically 
have definitions that differed from the example definitions presented. The definitions could 
differ in either the data, the rules, or both. 
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15 



Bl:<?xml version = "1.0" ?> 

B2:<!DOCTYPE CardDocument SYSTEM '" . . \dtd\com\gemplus\xml\SCIDL . dtd"> 
B3: 
5 B4: 

B5 : <CardDocument> 

B6:<Profile Type = M GeraXplore98" Version = "0.1 n > 

B7_: <S.i.qn.a.ture Ty pe = " Card">0x 80 0x69 OxAF 0x 03 0x07 0x03 0x5 2 . Ox 00 0x00 

B8:0x0A OxOE 0x83 0x3E 0x9F 0xl6</Signature> " ~" 

B9: 

BIO: <Process Name - "GetCardinf o"> 

Bll: <Doc>The process represents the manner to retreive the card 
B12 : inf ormation</Doc> 

B13: <Doc>The members returned are not listed</Doc> 

B14 : i 

B15: <Variable Name = "cardSerialNumberFile" Type = "byteArray" 
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B16:Default = "0x2F 0xE2"/> 
B17: <Variable Name = 

B18:0x00"/> 

B19: <Variable Name = 

"0x00 B20:0x00"/> 



B21 
B22 
B23 
B24 
B25 
B26 
B27 
B28 
B29 
B30 



<Variable Name 



0x00"/> 



"RFU_1" Type = "byteArray" Default - "0x00 
"memoryLeft" type - "byteArray" Default = 
"fileld" Type = "byteArray" Default = "0x00 



<Variable Name 
<Variable Name 



"fileType" Type - "byte" Default = "0x00"/> 
"fileFeatures" Type = "byteArray" Default = 
"0x00 0x00 0x00 0x00 0x00"/> 

<Variable Name = "restOf Response" Type = "byte" Default * 

"0x00"/> 



<Variable Name 
<Variable Name 



Default B31:= ""/> 



<Variable Name 
<Variable Name 
<Variable Name 
<Variable Name 
"8" Default = ""/> 



"index" Type = "byte" Default = "0"/> 
"value" Type = "byteArray" Length = "8" 

"offset_l" Type = "byte" Default = "0x00"/> 
"offset_2" Type = "byte" Default = "0x00"/> 
"length" Type = "byte" Default = "0x08"/> 
"CardSerialNumber" Type = "byteArray" Length 



"cardlnf ormationFile" Type = "byteArray" 

Type = "byteArray" 



B32 
B33 
B34 
B35 
B36 
B37 

B38: <Variable Name = 

Default B39:= "0x2F 0x30"/> 

B40: <Variable Name = "LastTransactionlnf o" 

Length B41:= "16" Default = ""/> 

B42: <Variable Name = "LastTransactionDate" Type - "byteArray" 

Default B43:= "0x00 0x00 0x00"/> 

B44: <Variable Name = "LastTransactionAmount " Type = "byteArray" 

B45: Default = "0x00 0x00 0x00"/> 

B46: <Variable Name = "transactionType" Type = "byte" Default = 

B47:"0x00"/> 

B4 8: 

B4 9: <Variable Name 

B50:"0x2F 0x31"/> 
B51: <Variable Name 

"0x00 B52:0x00 0xOO"/> 
B53: 

B54: <Variable Name 

B55:"0x2F 0x32"/> 



= "cardBalanceFile" Type - "byteArray" Default ■ 
= "cardBalarice" Type - "byteArray" Default = 

= "cardHolderFile" Type = "byteArray" Default = 
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B56 
B57 
B58 
B59 
B60 
B61 



<Variable Name = "CardHolderName" Type = "byteArray" Length 
^20" Default = ""/> 



<Apdu Id = "Select"> 
<Command> 

<Header Class = "OxAO" Ins 



"0xA4" PI 



"0" P2 = "0" 



Lc B62:= "2" Le 



'0x20"/> 
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OOO 




vin^caraoeriaiiNuiuDerr i±e<- / in-? 


OOfi 




</Comniand> 






~~ ^RespWse-Status-=-"Normal-Endi-ng J! -NGt-if-y =-^DoNotNotif_y'!> 


B66 




<0ut>RFU_K/0ut> 


B67 




<Out >memor yLef t < /Out > 


B68 




<Out>fileId</Out> 


B69 




<Out>fileType</Out> 


B70 




<Out>f ileFeatures</Out> 


_ B71 




<Out>restOf Response</Outx/Response> 


B72 




<Response ~St¥tus = M Mem^ryPrbblem"xOut>"10n- Error "</Out> 


B73 


</Response> 




B74 




<Response Status = "OutOf Range"xOut> "20nError" </Out> 


B75 


• </Response> 




B76 




<Response Status = "FileOrPatternNotFound"xOut> "@OnError" 


B77 


</Out> </Response> 


B78 




<Response Status = "IncorrectLength"xOut> "30nError" 



"IncorrectPlP2"><0ut> "40nError" </Out> 
"IncorrectClass"><Out> "SOnError" </Out> 



</Out> B79:</Response> 
B80: <Response Status 

B81:</Response> 

B82: <Response Status 

B83:</Response> 
B84: </Apdu> 
B85- 

B86: <Apdu Id = "ReadBinary"> 

B87: <Command> 

B88: <Header Class = "OxAO" Ins = "OxBO" PI = "offsetJL" P2 - 

B89:"offset_2" Le « "length"/> 
B90: ~ <In>"Void"</In> 

B91: </Command> 

B92: <Response Status = "NormalEnding" Notify = "DoNotNotif y"> 

B93 : <Out>CardSerialNumber</Outx/Response> 
B94: <Response Status = "MemoryProblem"XOut> "Memory 

B95:problem"</Out> </Response> 

B96: <Response Status = "NoneFileSelected"xOut>"File not 

B97;selected"</Out> </Response> 

B98: <Response Status = "WrongTypeOf File"XOut>"Wrong type of 

B99: f ile"</Out> </Response> 

B100: <Response Status - "WrongAccessCondition"><Out>"Access 

B101 :condition"</Out> </Response> 

B102: <Response Status = "FileInvalidated"xOut> "lOnError" 

</Out> B103:</Response> 

B104: <Response Status - "IncorrectPlP2"xOut> "20nError" </Out> 

BIOS :</Response> 

B106: <Response Status = "IncorrectClass"xOut> "30nError" 

</Out> B107:</Response> 



B108 
B109 
B110 
Bill 
B112 



</Apdu> 

<Apdu Id = "Select"> 
<Command> 

<Header Class = "OxAO" Ins = "0xA4" PI 



"0" P2 



"0" 



Lc B113:= "2" Le = "0xl0"/> 
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B114 
B115 
B116 
' B117 
B118 
B119 
B120 
B121 
B122 
BT23 
B124 
B125 
B126 
B127 



<In> cardInformationFile</In> 
</Command> 

<Response Status - "NormalEnding" Notify 
<Out>RFU_K/Out> 
<Out>memoryLef t</Out> 
<Out>fileId</Out> 
<Out>f ileType</Out> 
<Out>f ileFeatures</Out> 
<Out>restOfResponse</Outx/Response> 



"DoNotNotify"> 



<Re sponse-St a tus-=-"Memor y Pr obl-em ,J -><Out->-"On-Er-ror-^.</Out> 

</Response> 

<Response Status = "OutOf Range"xOut> "OnError" </Out>" 
</Response> . 

<Response Status = "FileOrPatternNotFound"xOut> 
"GOnError" B128:</Out> </Response> 

B_129: < Response ^Status = "IncorrectLength"xOut> "OnError" 

</Out> B130:</Response> ~~ - — 
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B131 
B132 
B133 
B133 
B134 
B135 
B136 
B137 
B138 
B139 
B140 
B141 
B142 
B143 
B144 
B145 
B146 
B147 
B148 
B149 
B150 



<Response Status = "IncorrectPlP2 "><Out> "OnError" </Out> 

</Response> 

<Response Status = "Incorrect Class "><Out> "OnError" </Out>. 

</Response> 

</Apdu> 



<Apdu Id = "ReadBinary"> 
<Command> 

<Header Class = "OxAO" Ins - "OxBO" PI = "offset_l" P2 = 
"offset_2" Le - "50"/> 

<In>"Void"</In> 
</Command> 

<Response Status = "NormalEnding" Notify = "DoNotNotify"> 
<Out>LastTransactionDate</Out> 
<Out>LastTransactionAmount</Out> 
<Out > trans act ionType</Out> 
<Out>LastTransactionInfo</Out> 
</Response> 

<Response Status = "MemoryProblem"X0ut>"0n Error"</Out> 

</Response> 

<Response Status = "NoneFileSelected"X0ut> "OnError" 
</Out> B151 :</Response> ■ 

B152: <Response Status = "WrongTypeOf File"><0ut> "OnError" 

</Out> B153:</Response> 

B154: <Response Status = "WrongAccessCondition" Notify = 

"Plugln"> 

B155: <Out>"pluginMessage?secretCode=01"</Outx/Response> 
B156: <Response Status = "FileInvalidated"xOut> "OnError" 

</Out> B157:</Response> 



B158 
B159 
B160 
B161 
B162 
B163 
B164 
B165 
B166 
B167 
B168 
B169 



<Response Status = "IncorrectPlP2"xOut> "OnError" </Out> 

</Response> 

<Response Status = "IncorrectClass"xOut> "OnError" </Out> 

</Response> 

</Apdu> 



<Apdu Id = "ReadBinary"> 
<Command> 

<Header Class = "OxAO' 
"offset_2" Le - "50"/> 

<In>"Void"</In> 
</Command> 



Ins 



"OxBO" N P1 



"offset 1" P2 
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B170 
B171 
B172 
B173 
B174 
B175 
B176 
B177 
B178 



</Response> 



<Response Status = "NormalEnding" Notify = "DoNotNotif y M > 
<Out>LastTransactionDate</Out> 
<Out>LastTransactionAmount</Out> 
<Out>transactionf ype</0ut> 
<Out>LastTransactionInf o</0ut> 
</Response> 

<Response Status = "MemoryProblem"x0ut>"On Error"</Out> 
<Response Status = "NoneFileSelected"XOut> "OnError" 



10 </Out> B17 9: </Response> ~~ L 

B180: <Response Status - "WrongTypeOf File"xOut> "OnError" 

</Out> B181:</Response> 

B182: <Response Status = 

B183: "WrongAccessCondit ion "><Out> "OnError "< /Out ></Response> 
15 B184: <Response Status = "FileInvalidated"xOut> "OnError" 

... </-Out> Bl 8 5_:< /Response? 

B186: <Response Status « ,r IncorrectPIP2"><Out>- "OnError /Out >— 

B187 :</Response> 

B188: <Response Status = "IncorrectClass"><Out> "OnError" </Out> 

20 B189:</Response> 
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B190: 
B191: 
B192: 
B193: 
B194 

Lc B195: 
B196: 
B197: 
B198: 
B199: 
B200: 
B201: 
B202: 
B203: 
B204 : 
B205: 



</Apdu> 



•0" P2 = "0 r 



<Apdu Id = "Select "> 
<Command> 

<Header. Class = "OxAO" Ins - "0xA4" PI 
"2" Le - "0xl0"/> 

<In>cardBalanceFile</In> 
</Command> 

<Respbnse Status = "NormalEnding" Notify = "DoNotNotif y"> 
<Out>RFU_K/Out> 
<Out>meraoryLeft</Out> 
<Out>fileId</Out> 
<Out>fileType</Out> 
<Out>f ileFeatures</Out> 
<Out>restOf Response</Outx/Response> 

<Response Status = "MemoryProblem M ><Out>"On Error"</Out> 
B206:</Response> 

B207: <Response Status - "OutOf Range"xOut> "OnError" </Out> 

B208:</Response> 

B209: <Response Status = "FileOrPatternNotFound"XOut> 

"GOnError" B210:</Out> </Response> 

B211: <Response Status = "IncorrectLength"xOut> "OnError" 

</Out> B212:</Response> 



B213 
B214 
B215 
B216 
B217 
B218 
B219 
B220 
B221 
B222 
B223 
B224 
B225 
B226 



<Response Status = "IncorrectPlP2"XOut> "OnError" </Out> 

</Response> 

<Response Status = "IncorrectClass"><Out> "OnError" </Out> 

</Response> 

</Apdu> 

<Apdu Id = "ReadBinary"> 
<Command> 

<Header Class = "OxAO" Ins = "0xB0" PI = "offset_l"' P2 = 
"offset_2" Le = "3 f 7> 

<In>"Void"</In> 
</Command> 

<Response Status = "NormalEnding" Notify = "DoNotNotif y"> 
<Out>cardBalance </0utx/Response> 
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B227: <Response Status = "MemoryProblem"xOut>"On Error "</Out> 

B228:</Response> 

B229: <Response Status = "NoneFileSelected"xOut > "OnError" 

</Out> B230:</Response> 

B231: <Response Status = "WrongTypeOf File"xOut> "OnError" 

</Out> B232:</Response> 

B233: <Response Status = "WrongAccessCondition" Notify = 

"Plugln"> 

: B234-: ^<Ou.t^E^.gAn^s^ge?s^c£etCode=01"</Out></Response> 

B235: <Response Status = "FileIrv^ll^at7Bid">-<Out>-"-0nEr-rarS 

</Out> B236:</Response> 

B237: <Response Status = "IncorrectPlP2"><Out> "OnError" </Out> 

B238:</Response> 

B239: <Response Status = "IncorrectClass"xOut> "OnError" </Out> 

B24 0 : </Response> 

B24H </Apdu>-- 

B242: ' "~ — 

B24 3: <Apdu Id - "Select "> 

B24 4 : <Command> 

B245: <Header Class = "OxAO" Ins = "0xA4" PI = "0" P2 = "0" 

Lc B246:= "2" Le - "0xl0"/> 

B24 7: <In>cardHolderFile</In> 

B24 8: </Command> 

B249: <Response Status = "NormalEnding" Notify = "DoNotNotif y"> 

B250: <0ut>RFU_K/0ut> 

B251: <0ut>memoryLeft</0ut> 

B252: <0ut>f ileld</0ut> 

B253: <Out>f ileType</Out> 

B254 : <Out>f ileFeatures</Out> 

B255: <0ut>rest0fResponse</0utx/Response> ■ 

B256: <Response Status = "MemoryProblem"xOut>"On Error"</Out> 

B257:</Response> 

B258: <Response Status = "OutOf Range"><Out> "OnError" </Out> 

B259:</Response> 

B260: <Response Status = "FileOrPatternNotFound"><Out> 

"QOnError" B261:</Out> </Response> 

B262; • <Response Status = "IncorrectLength"xOut> "OnError" 

</Out> B263:</Response> 

B264: <Response Status = "IncorrectPlP2"xOut> "OnError" </Out> 

B265 : </Response> 

B266: <Response Status = "IncorrectClass"xOut> "OnError" </Out> 

B267 : </Response> 
B268: </Apdu> 
B269: 

B270: <Apdu Id - "ReadBinary"> 

B271: <Command> 

B272: <Header Class - "OxAO" Ins = "OxBO" PI = "offset_l" P2 = 

B273:"offset_2" Le = "20"/> 
B274: <In>"Void"</In> 
B275: </Command> 

B276: <Response Status = "NormalEnding" Notify = "DoNotNotif y"> 

B277 : <Out>CardHolderName</Outx/Response> 

B278: <Response Status = "Memory Problem"xOut> "On Error"</Out> 

B279:</Response> 

B280: <Response Status = "NoneFileSelected"xOut> "OnError" 

</Out> B281:</Response> 

B282: <Response Status = "WrongTypeOf File"X0ut> "OnError" 

</Out> B283:</Response> 
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B284: <Response Status = "WrongAccessCondition" Notify = 

"Plugln"> 

B285: <Out>"pluginMessage?secretCode=01"</Outx/Response> 
B286: <Response Status - "FileInvalidated"xOut> "OnError" 

5 </Out> B287 :</Response> 

B288: <Response Status - "IncorrectPlP2"xOut> "OnError" </Out> 

B289:</Response> 

B290: <Response Status - "IncorrectClass"xOut> "OnError" </Out>. 

B*291T<:7Response> — : — J_ 

10 B292: </Apdu> "~ ' — 

B293: </Process> 
B294: 

B295: <Process Name = "verify"> 

B296: <Variable Name = "index" Type = "byte" Default = "0"/> 
-15.. _B2?7j <Variable Name = "value" Type = "byteArray" Length = "8" 
Default B298:=~""/> — - - 

B299: ' <Apdu Id = "VerifyCHV"> ~ ~ ~ 

B300: <Coiiimand> 

B301: <Header Class - "OxAO" Ins = "0x20" PI = "0x00" P2 = 

20 "index" B302:Lc = "0x08"/> 

B303: <In>value</In> 
B304: </Command> 

B305: <Response Status = "NdrmalEnding" . Notify = "DoNotNotif y"> 

B306 : <Out>"Void"</Outx/Response> 
25 B307: <Response Status = "MemoryProblem"><0ut>"0n Error"</Out> 

B308 :</Response> 

B309: <Response Status = "NoneFileSelected"xdut> "OnError" 

</Out> B310:</Response> 

B311: <Response Status = "OutOf Range "><Out> "OnError" </Out> 

30 B312:</Response> 

B313: <Response Status = "WrongTypeOf File"xOut> "OnError" 

</Out> B314 :</Response> 

B315: <Response Status = "WrongAccessCondition"xOut> "OnError" 

B316:</Out> </Response> 
35 B317: <Response Status - "CHVBlocked"><Out> "OnError" </Out> 

B318 : </Response> 

B319: <Response Status ■> "IncorrectLength"><Out > "OnError" 

</Out> B320:</Response> 

B321: <Response Status = "IncorrectPlP2"><Out> "OnError" </Out> 

40 B322 : </Response> 

B323: <Response Status = "IncorrectClass"xOut> "OnError" </Out> 

B324 :</Response> 

B325: </Apdu> 

B326: </Process> 
45 B327: 

B328: <Process Name - "TransactionAward"> 

B329: <Doc>The process represents the ward transaction</Doc> 
B330: <Doc>The members returned are not listed</Doc> 
B331:. 

50 B332: <Variable Name = "cardBalanceFile" Type = "byteArray" Default = 

B333:"0x2F 0x31"/> 

B334: <Variable Name = "RFU_1" Type = "byteArray" Default - "0x00 

B335:0x00"/> 

B336: <Variable Name = "memoryLeft" Type = "byteArray" Default = 

55 "0x00 B337:OxO0"/> 

. B338: <Variable Name = "fileld" Type = "byteArray" Default = "0x00 

B339:OxO0"/> 

B340: <Variable Name = "fileType" Type "byte" Default = "0x00 M /> 
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B341 
B342 
B343 
B344 
B345 
B346 
B347 
B34 8 
— B34-9 
B350 



"byteArray" Default 



<Variable Name « "f ileFeatures" Type 
'OxOO 0x00 0x00 OxOO 0x00"/> 

<Variabie Name = "restOf Response" Type = "byte" Default = 
'0x00"/> 



<Variable Name = "offset_l" Type = "byte" Default = "0x00"/> 
<Variabie Name = "offset^" Type =."byte" Default = "0x00"/> 
<Variable Name = "cardBalance" Type = "byteArray" Default = 
^0x00_0x0,0_0x00"/> 



<Variable Name = "newBarance""~Type~=- -"byteArray^— Defaults 

"0x00 B360:0x00 0x00"/> 
B361: 

B362: <Variable Name = "cardlnf ormationFile" Type = "byteArray" 

Default B363:= "0x2F 0x30"/> 
B364 ; 

B365: <Variable -Name =_ ".date" Type = "byteArray" Default = "0x00 

0x00 B366:0x00"/> — 

B367: <Variable Name = "amount" Type = "byteArray" Default = "0x00 0x00 

B368:0x00"/> 

B369: ^Variable Name = "transactionType" Type = "byte" Default = 

B370: "0x01 "/> 

B371: <Variable Name =• "transaction" Type = "byteArray" Length = 

"16" B372:Default = ""/> 

B373: 

B374: <Variable Name = "cardBalanceFile" Type = "byteArray" Default « 

B375:"0x2F 0x31"/> * ' . 

B376: <Variable Name = "cardBalance" Type = "byteArray" Default = 

B377:"0x00 0x00 0x00"/> 

B378: 

B37 9: <Apdu Id = "Select "> 

B380: <Command> 

B381: <Header Class = "OxAO" Ins - "0xA4" PI = "0" P2 - "0" 

Lc B382:= "2" Le = "0xl0"/> 

B383: <In>cardBalanceFile</In> 

B384: </Command> 

B385: <Response Status = "NormalEnding" Notify = "DoNotNotif y"> 

B38 6: <Out>RFU_K/Out> 

B387: <Out>memoryLeft</Out> 

B388: <Out>fileId</Out> 

B38 9: <Out>fileType</Out> 

B390: <Out>fileFeatures</0ut> 

B391 : <Out>restOf Response</Outx/Response> 

B392: <Response Status = "MemoryProblem"X0ut>"0n Error "</Out> 

B393:</Response> 

B394 : <Response Status = "OutOf Range"xOut> "OnError" </Out> 

B395:</Response> 

B396: <Response Status = "FileOrPatternNotFound"><Out> 

"@OnError" B397:</Out> </Response> 

B398: <Response Status = "IncorrectLength"><Out> "OnError" 

</Out> B399:</Response> 



B4 00 
B401 
B402 
B403 
B4 04 
B405 
B406 
B407 



<Response. Status = "IncorrectPlP2"><0ut> "OnError" </Out> 

</Response> 

<Response Status = "IncorrectClass"><Out> "OnError" </Out> 

</Response> 

</Apdu> 

<Apdu Id = "ReadBinary"> 
<Command> 
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B408: 

B409:"offset_2" 

B410: 

B411: 

B412: 

B413: 

B414: 

B415:</Response> 

-B4-1 6 : 

</Out> 
B418: 
</Out> 
B420: 



<Header Class - "OxAO" Ins = "OxBO" PI = "offset_l" P2 = 
Le = "3"/> 
<In>"Void"</In> 

</Command> 

<Response Status = "NormalEnding" Notify « "DoNotNotif y"> 
<Out>cardBalance</Outx/Response> 
<Response Status = "MemoryProblem"xOut>"On Error"</Out> 



^Response Status 



"NoneFileSelected"xOut> "OnError" 



B417:</Response> — 

<Response Status = "WrongTypeOf File"xOut> "OnError" 
B419: </Response> 

<Response Status 



B4 21: "WrongAccessCondition"xOut>"OnError"</Outx/Response> 
B422: <Response Status = "FileInvalidated"xOut> 
~</Out> B423:</Response> . 



"OnError" 



B424 
B425 
B426 
B427 
B428 
B429 
B4 30 
B431 
B432 
"0x00" 
B434 
B435 
B436 
B437 
B438 
B439 
B440 
B441 
B442 



<Response Status = "IncorrectPlP2"xOut> ""OnError" </Out> - 

</Response> 

<Response Status = "IncorrectClass"xOut> "OnError" </Out> 

</Response> 

• </Apdu> 

<Apdu Id = "Callback"> 
<Command> 

<Header Class = "0x00" Ins = "0x00" PI - "0x00" P2 = 
B432: Lc = "0x00" Le = "0x00"/> 

<In>"awardBalance?balance=cardBalance"</In> 
</Command> 

<Response Status = "NormalEnding" Notify = "DoNotNotif y"> 
<Out>newBalance</Outx/Response> 
'</Apdu> ' 



<Apdu Id = "Callback"> 
<Command> 

<Header Class = "0x00" Ins = "0x00" PI = "0x00" P2 = "0x00" 
B443:Lc - "0x00" Le = "0x00"/> 
B444 : <In>"crypto?award=DES"</In> 
B445: </Command> 

B44 6: ^Response Status = "NormalEnding" Notify = 

B447 : "DoNotNotif y"XOut>"Void"</Outx/Response> 
B44 8: </Apdu> 
B449: 

B450: <Apdu Id = "Select"> 

B451: <Command> 
B452: <Header Class 

Le = "0xl0"/> 

<ln>cardlnf ormationFile</In> 
</Command> 

<Response Status = "NormalEnding" Notify 
<Out>RFU_K/Out> 
<Out>memoryLeft</Out> 
<Out>fileId</0ut> 
<Out>fileType</Out> . 
<Out>f iieFeatures</Out> 
<Out>restOf Response</Outx/Response> 
<Response Status = "MemoryProblem"xOut>"On Error "</0ut> 



Lc B453:= 
B454 : 
B455: 
B456: 
B457: 
B458: 
B459: 
B460: 
B4 61: 
B4 62: 
B463: 
B464 :</Response> 



"OxAO" Ins - "0xA4" PI = "0" P2 = "0" 



"DoNotNotify"> 
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B4 65: <Response Status = "OutOf Range"xOut> "OnError" </Out> 

B4 66 : </Response> 

B4 67: <Response Status = "FileOrPatternNotFound"xOut> 

"GOnError" B4 68:</Out> </Response> 

B4 69: <Response Status = "IncorrectLength"XOut> "OnError" 

</Out> B470:</Response> 

B471: <Response Status = "IncorrectPlP2"xOut> "OnError" </Out> 

B4 72:</Response> 

— B4-7-3:— ____<Response^ Status = "IncorrectClass M xOut> "OnError" </Out> 



B474 : </Response> 
B4 75: </Apdu> 
B476: 

B477: <Apdu Id = "UpdateBinary"> 

B478: <Command> 

B479: <Header Class = "OxAO" Ins = "0xD6 
B480": "of f set- 2-"- Lg "0xl.7„"/> 



PI = "offset 1" P2 = 



B481: 
B482: 
B483: 
B484 : 
B485: 
B486: 
B487 : 
B488 : 



<In>date</In> 
<In>amount</In> 
<In>transactionType</In> 
<In>transaction</In> 
</Command> 

<Response Status = "NormalEnding" Notify = "DoNotNotif y M > 
<Out>"Void"</Outx/Response> 
<Response Status - "MemoryProblem"><0ut>"0n Error"</Out> 



B4 89:</Response> 

B490: <Response Status 

</Out> B4 91:</Response> 

B4 92: <Response Status 

</Out> B493:</Response> 

B494: <Resppnse Status 

B4 95:</0ut> </Response> 

B4 96: <Response Status 

</Out> B4 97:</Response> 

B4 98: <Response Status 

B499: </Response> 

B500: <Response Status 

B501:</Response> 



"NoneFileSelected"><Out> "OnError" 
"WrongTypeOfFile' r xOut> "OnError" 
"WrongAccessCondit ion " xOut > "OnError " 
"FileInvalidated"><Out> "OnError" 
"IncorrectPlP2"><Out> "OnError" </Out> 
"IncorrectClass"xOut> "OnError" </Out> 



B502: 
B503: 
B504 : 
B505: 
B506: 
Lc B507 
B508: 
B509: 
B510: 
B511: 
B512: 
B513: 
B514 : 
B515: 
B516: 
B517: 



</Apdu> 



'OxAO" Ins = "0xA4" PI = "0' 



P2 = "0" 



"DoNotNotify"> 



<Apdu Id = "Select "> 
<Command> 
<Header Class = 
"2" Le = "0xl0"/> 

<In>cardBalanceFile</In> 
</Command> 

<Response Status = "NormalEnding" Notify 
<Out>RFU_K/Out> 
<Out>memoryLef t</Out> 
<Out>fileId</Out> 
<Out>fileType</Out> 
<Out>fileFeatures</Out> 
<Out>restOfResponse</Outx/Response> 
<Response Status = "MemoryProblern"xOut>"On Error"</Out> 
B518:</Response> 

B519: <Response Status = "OutOf Range"><Out> "OnError" </Out> 

B520: </Response> 

B521: <Response Status - "FileOrPatternNotFound"xOut> 

"@OnError" B522:</Out> </Response> 
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B525 
B526 
B527 
B528 
B529 
B530 

-B53.1. 
B532 
B533 
B534 
B535 
B536 
B537 

-B53-8 
B539 
B540 
B541 



<Response Status = "IncorrectPlP2"xOut> "OnErrcr" </Out> 

</Response> 

<Response Status = "IncorrectClass"xOut> "OnError" </Out> 

</Response> 

</Apdu> 



_< Apdu^Jci_ f_^£pd a t e B i n a r y " > 
<Command> 



<Header Class - "OxAO" Ins = "0xD6" PI = "offset_l M P2 = 
'offset_2" Lc = ,, 3. ,, /> 

<In>newBalance</In> 
</Command> 

<Response Status = "NormalEnding" Notify = "DoNctNotif y"> 
- - _ .<0.ut> ,, Void"</Out></Response> 

<Response Status = ,T MenToryPfbbrem r, ><Out>"On- Error "< /-Out >- 

:</Response> 

<Response Status = "NoneFileSelected"xOut> "OnError" 
</Out> B542:</Response> 

B543: " <Response Status = "WrbngTypeOf File"><Out> "OnError" </Out> 

B54 4 :</Response> 

B54 5: <Response Status = "WrongAccessCondition"><Out> "OnError" 

B546:</Out> </Response> 

B547: <Response Status = "FileInvalidated"><Out> "OnError" 

</Out> B54 8:</Response> 

B54 9: <Response Status = "IncorrectPlP2"xOut> "OnError" </Out> 

B550: </Response> 

B551: <Response Status = "IncorrectClass"><Out> "OnError" </Out> 

B552:</Response> 
B553: </Apdu> 
B554: </Process> 
{ B555: <Process Name = "TransactionRedeem"> 
B556: <Doc>The process represents the redeem transaction </Doc> 
B557: <Doc>The members returned are not listed</Doc> 
B558: 

B559: <Variable Name = "cardBalanceFile" . Type - "byteArray" Default = 

. B560:"0x2F 0x31"/> 

B561: <Variable Name 

B562:0x00"/> 

B563: <Variable Name 

"0x00 B564:0x00"/> 
B565: <Variable Name 

B566:0x00"/> 

B567: <Variable Name 

B568: <Variable. Name 

B569:"0x00 0x00 0x00 0x00 0x00"/> 

B570: <Variable Name = "restOf Response" Type 

B571:"0x00 M />. 
B572: 

B573: <Variable Name = "offset_l" Type = "byte" Default = "0x0O"/> 

B574: <Variable Name = "offset_2" Type = "byte" Default = "0x0O"/> 

B575: <Variable Name = "cardBalance" Type = "byteArray" Default = 

B576: M 0x00 0x00 0xOO"/> 

B577: <Variable Name = "newBalance" Type = "byteArray" Default ■» 

"0x00 B578:0x00 0xOO"/> 
B579: 



"RFU_1" Type = "byteArray" Default = "0x00 

"memoryLeft" Type = "byteArray" Default = 

"fileld" Type - "byteArray" Default = "0x00 

"fileType" Type = "byte" Default "0x0O"/> 
"f ileFeatures" Type = "byteArray" Default = 

"byte" Default « 
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B580: <Variable Name - "cardlnf ormat ion File" Type = "byteArray" 

Default B581:= "0x2F 0x30"/> 

B582: 

B583: <Variable Name = "date" Type = "byteArray" Default = "0x00 

5 0x00 B584:0x00"/> 

B585: <Variable Name = "amount" Type = "byteArray" Default = "0x00 0x00 

B586:0xOO"/> 

B587: <Variable Name = "transactionType" Type - "byte" Default = 
" B 5-8-8 :"0x02^/>-. . 

10 B589: <Variable Name = "transact ion "~Type" =-"byteAr-r-ay^-Length^ 

"16" B590: Default = ""/> 
B591: 

B592: <Variable Name = "cardBalanceFile" Type = "byteArray" Default = 

B593:"0x2F 0x31"/> 

1^ B594: <Variable Name = "cardBalance" Type = "byteArray" Default = 
~~ ~B5"95": "0x00-0x00 0x00 "-/-> 

B596: v ~ 

B597: <Apdu Id = "Select"> 

B598: <Command> 
20 B599: <Header Class = "OxAO" Ins = "0xA4" PI = "0" P2 = "0" 

Lc B600:= "2" Le = "0xl0"/> 

B601 : <In>cardBalanceFile</In> 

B602: </Command> 

B603: <Response Status = "Normal Ending" Notify - "DoNotNotif y"> 

25 B604: <Out>RFU_K/Out> 

B605: <Out>memoryLeft</Out> 

B606: <Out>fileId</Out> 

B607: <Out>fileType</Out> 

B608 : <Out>f ileFeatures</Out> 

30 B609: <Out>restOfResponse</Out></Response> 

B610: <Response Status = "MemoryProblem"xOut>"On Error"</Out> 

B611 : </Response> 

B612: <Response Status = "OutOf Range"><Out> "OnError" </Out> 

B613 : </Response> 

35 B614: . xResponse Status = "FileOrPatternNotFound"><Out> " 

"@OnError" B615:</Out> </Response> 

B616: <Response Status - "IncorrectLength"><Out> "OnError" 

</Out> B617:</Response> 

B618: <Response Status = "IncorrectPlP2"xOut> "OnError" </Out> 

40 B619:</Response> 

B620: <Response Status = "IncorrectClass"xOut> "OnError" </Out> 

B621 :</Response> 
B622: </Apdu> 
B623: 

45 B624: <Apdu Id = "ReadBinary "> 

B625: <Command> 

B626: <Header Class = "OxAO" Ins = "OxBO" PI - "offset_l" P2 • = 

B627:"offset_2" Le = "3"/> 
B628: <In>"Void"</In> 
50 B629: </Command> 

B630: <Response Status = "NormalEnding" Notify = "DoNotNotif y"> 

B631 : <Out>cardBalance</OutX/Response> 

B632: <Response Status = "MemoryProblem"xOut>"On Error"</Out> 

B633: </Response> 

55 B634: <Response Status = "NoneFileSelected"><Out> "OnError" 

</Out> B635:</Response> 

B636: <Response Status = "WrongTypeOf File"xOut> "OnError" 

</Out> B637:</Response> 
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"0x00" P2 



B638: <Response Status' « 

B639: "WrongAccessCondition"xOut>"OnError"</Outx/Response> 

B640: <Response Status = "Filelnvalidated"><0ut> "OnError" 

</Out> B641 : </Response> 

B642: <Response Status = "IncorrectPlP2"X0ut> "OnError" </Out> 

B643 : </Response> 

B644 : <Response Status = "IncorrectClass"xOut> "OnError" </Out> 

B645 : </Response> 

B64 6: </Apd u>_ 

B647 : ----- .,_ _____ _______ __ 

B648 : 
B649: 
B650 
"0x00 
B652 
-B653 
B654 
B655 
B656 
B657 
B658 
B659 
B660 

B661:Lc 
B662: 
B663: 
B664 : 



<Apdu Id = "Callback"> 
<Command> 

<Header Class = "0x00" Ins =."0x00" PI 
B651: Lc = "0x00" Le = "0x00"/> 

<In>"redeemBalance?balance=cardBalance"</In> 
</Command> 

<Response Status = " Norma XEndlng"^ Notify "DoNotNoti-f y- >- 
<Out>newBalance </Outx/Response> 

</Apdu> 



Ins 



'0x00" PI "0x00" P2 - "0x00' 



P2 = "0 f 



"DoNotNotify'^ 



<Apdu Id = "Callbacks 
<Command> 

<Header Class = "0x00* 
"0x00" Le = "0xO0"/> 

<In> "crypt o?award=DES"</In> 
</Command> 

<Response Status = "NormalEnding" Notify 
B665 : "DoNotNotif y"X0ut>"Void"</0utx/Response> 
B666: </Apdu> 
B667: 
B668: 
B669: 
B670: 
Lc B671: 
B672: 
B673: 
B674 : 
B675: 
B676: 
B677: 
B678: 
B679: 
B680: 
B691: 

B692 : </Response> 

B693: <Response Status 

B694 : </Response> 

B.695: <Response Status - "FileOrPatternNotFound"xOut> 

"GOnError" B696:</Out> </Response> 

B697: <Response Status = ^IncorrectLength"XOut> "OnError" 

</Out> B698 :</Response> 

B699: <Response Status = "IncorrectPlP2"><Out> "OnError" </0ut> 

B700:</Response> 

B701: <Response Status = "IncorrectClass"xOut> "OnError" </Out> 

B702:</Response> 
B703: </Apdu> 
B704 : 

B705: <Apdu Id = "UpdateBinary"> 



<Apdu Id - "Select "> 
<Command> 

<Header Class = "OxAO" Ins = "0xA4" PI ~ 
"2" Le = "0xl0"/> 

<In>cardInformationFile</In> 
</Command> 

<Response Status = "NormalEnding" Notify 
<Out>RFU_K/Out> 
<Out>memoryLef t</Out> , 
<Out>fileId</Out> 
<Out > f i leType< /Ou t > 
<Out>fileFeatures</Out> 
<0ut>rest0fResponse</0utx/Response> 

<Response Status = "MemoryProblem"X0ut>"0n Error"</Out> 

"0ut0fRange"><0ut> "OnError" </Out> 
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B706 
B707 
B708 
B709 
B710 
B711 
B712 
B713 
— B'7-1-4- 
B715 
B716 
B717 
B718 



<Command> 

<Header Class = "OxAO" Ins = "0xD6" PI = "offset_l" P2 = 
"offset_2" Lc = "0xl7"/> 
<In>date</In> 
<In>amount</In> 
<In>transactionType</In> 
<In>transaction</In> 
</Command> 

xRespons.e_Atajtus_^ formal Ending" Notify = "DoNotNotif y"> 



<Out>"Void"</Outx/Response> 



<Response Status = "MemoryProblem"xOut>"On Error"</Out> 

</Response> 

<Response Status = ' f NoneFileSelected"xOut> "OnError" 
</Out> B719:</Response> 

B720: <Response Status = "WrongTypeOf File"xOut> "OnError" 

<70ut>~B721 :</Response> . : — " _ 

B722: <Response Status 

B723:</Out> </Response> 
B724: <Response Status 

</Out> B725:</Response> 
B726: <Response Status 

B727:</Response> 

B728: <Response Status 

B729:</Response> 



"WrongAccessCondition n ><Gutf>~"OnError"~ 
"FileInvalidated"X0ut> "OnError" 
"Incorrect PlP2"xOut> "OnError" </Out> 
"IncorrectClass"><0ut> "OnError" </Out> 



B730: 
B731: 
B732: 
B733: 
B734: . 
Lc B735:* 
B736: 



</Apdu> 



<Apdu Id - "Select "> 
<Command> 

<Header Class - "OxAO" Ins - "0xA4" PI = "0" P2 = "0" 
"2" Le = "0xl0"/> 

<In>cardBalanceFile</In> 
B737: </Command> 

B739: <Response Status = "NormalEnding" Notify = "DoNotNotif y"> 

B740: <Out>RFU_K/Out> 
B741: <Out>memoryLeft</Out> 
B742: <Out>fileId</Out> 

B743: <Out>fileType</Out> r 

B744 : x <Out>fileFeatures</Out> 

. B74 5: <Out>restOf Response</Outx/Response> 

B74 6: <Response Status = "MemoryProblem"><Out> "On Error "</Out> 

B74 7 :</Response> 

B748: <Response Status = "OutOf Range"><Out> "OnError" </Out> 

B74 9:</Response> 

^ B750: <Response Status = "FileOrPatternNotFound"xOut> 

"GOnErrof" B751:</Out> </Response> 

B752: <Response Status = "IncorrectLength"xOut> "OnError" 

</Out> B753:</Response> 

B754:' % <Response Status = "Incorrect P1P2 "><Out> "OnError" </Out> 

B755 : </Response> 

B756: <Response Status = "IncorrectClass"xOut> "OnError" </Out> 

B757 : </Response> 
B758: </Apdu> 
B759: 

B7 60: <Apdu Id = "UpdateBinary"> 

B7 61: <Command> 

B762: <Header Class - "OxAO" Ins = "0xD6" PI - "offset__l" P2 = 

B763:"offset_2" Lc = "3"/> 

B764 : <In>newBalance</In> 
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B7 65: </Command> 

B766:' <Response Status = "NormalEnding" Notify = "DoNotNotif y M > 

N7 67: <Out>"Void"</OutX/Response> 

B7 69: <Response Status = "MemoryProblem"><Out> "On Error "</Out> 

B770:</Response> 

B771: <Response Status = "NoneFileSelected"><Out> "OnError" 

</0ut> B772:</Response> 

B773: <Response Status = "WrongTypeOf File"X0ut> "OnError" 

"<r/Ou t>~B-7 =) 4:<-/ Response >- 



10 B775: <Response Status = n WrongAccessCondition"><0ut> "OnError" - - 

B776:</Out> </Response> 

B777: <Response Status = "FileInvalidated"xOut> "OnError" 

</0ut> .B778:</Response> 

B779: <Response Status = "IncorrectPlP2"xOut> "OnError" </Out> 

15 B780:</Response> 

^ B7817 <Response- Status- =-"IncorrectClass"XQut^ ^OnE^qr; > </Out> 

B782:</Response> 

B783: </Apdu> 

B784: </Process> 
20 B785:</Profile> 

B786: 

B787 : <StatusWord> 

B788: <SW Verbose = "NormalEnding" Status = "0x9000"/> 
B789: <SW Verbose = "MemoryProblem" Status - "0x9240"/> 

25 B790: <5W Verbose = "NoneFileSelected" Status = "0x9400"/> 
B791: <SW Verbose - "OutOfRange" Status = "0x9402"/> 
B792: <SW Verbose = "FileOrPatternNotFound" Status = "0x9404"/> 
B793: <SW Verbose = "WrongTypeOf File" Status = "0x9408"/> 
B794: <SW Verbose = "CHVDoesNotExist " Status = "Ox9802"/> 

30 B795: <SW Verbose = "WrongAccessCondition" Status = "0x9804 "/> 

B796: <SW Verbose = "InContradictionWithTheCHVStatus" Status = "0x9808"/> 
B797: <SW Verbose = "CHVBlocked" Status - "0x9840"/> 
B798: <SW Verbose = "Filelnvalidated" Status = "0x98I0"/> 
B799: <SW Verbose = "IncorrectLength" Status = "Ox6700"/> 

35 B800: <SW Verbose = " Incorrect P1P2" Status - "0x6B00"/> 

B801: <SW Verbose = "IncorrectClass" Status = "0x6E00"/> 
B802 : </StatusWord> 
B803 : </CardDocument> 



40 APPLICATION BOOT 

The example of a boot file listed below from line CI through line CI 77 provides the 
data and rules for testing a dictionary for compatibility with the example application logic 
unit listed above. The rules described in the boot file for compatibility testing allow two 
types of smart cards to be approved as compatible with the example application logic unit. 

45 Specifically, the example boot file allows Gemplus GemXplore98, and Gemplus GemClub™ 
smart cards to be scanned and approved for compatibility with the application logic unit. 
The procedure implemented according to the rules of the boot file yields a unique, 
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predetermined value for each of these three compatible smart cards; This unique 
predetermined value is returned to the linking engine as the output value of the boot process 
and is used to test the compatibility of the card, as described in connection with Figure 6. 
___Additionally, the boot file includes an address where the dictionaries can be retrieved for 
5 compatibility testing. , 



Cl:<?xml version = "1.0" ?> 

C2:<!DOCTYPE CardDocument SYSTEM " . . \dtd\com\geraplus\sml . dtd"> 

10 C4:<! — * Copyright (c) 1997 - 1999 Gemplus group. All ~Rlgh~t"s~Resefved7 ~~ 
C5: — > 

C6: 

C7 : <CardDocument> 

C8:<Profile Type = "GemXplore98 M Version = "0.1"> 
15 C9: <Signature Type = "Application ' , > ,, signatures"</Signature> 
CIO: ... 
. Cll: <Process Name = "signatures"> 

C12: <Doc>This is the description of the getFile process to retreive 

the C13:path</Doc> 

20 C14: <Doc> of the XML file related to the Gemplus* GemXpresso smart 

C15:card</Doc> 

C16: <Doc> step 1 '- Select CardSerialNumber file </Doc> 
C17: <Doc> step 2 - Select GSM directory </Doc> 
C18: ' <Doc> step 3 - Select IMSI file </Doc> 
25 C19: <Doc> step 4 -Select Telecom directory </Doc> 
C20: 

C21: <Variable Name = "cardSerialNumberFile" Type = "byteArray" 

Default C22: = "0x2F 0xE2"/> 

C23: <Variable Name = "gsmDirectory" Type = "byteArray" Default = 

30 "0x7F C24:0x20"/> 

C25: <Variable Name = "imsiFile" Type = "byteArray" Default = "0x6F 

C26:0x09"/> 

C27: <Variable Name = "telecomDirectory-" Type = "byteArray" Default = 

C28:"0x7F 0xl0"/> 

35 C29: <Variable Name = "root" Type = "byteArray" Default = "0x3F 

0x00"/> 

C30: <Variable Name = "RFU_1" Type - "byteArray" Default = "0x00 0x00"/> 
C31: <Variable Name = "fileld" Type = "byteArray" Default = "0x00 
0x00"/> 

40 C32: <Variable Name - "memoryLeft" Type = "byteArray" Default = "0x00 

C33:0x00"/> 

C34: <Variable Name = "fileType" Type = "byte" Default = "0xOO"/> 

C35: <Variable Name = "f ileFeatures" Type = "byteArray" Default = 

"0x00 C36:0x00 0x00 0x00 Ox0O"/> 
45 C37: <Variable Name = "restOf Response" Type - "byte" Default- = 

"0x00" /> 

C38: <Apdu Id = "Select "> 
C39: <Command> 

C40: <Header Class = "OxAO" Ins - "0xA4" PI = "0" P2 = "0" Lc = 

50 C41:"2" Le = "0x20"/> 

C42: <In>cardSerialNumberFile</In> 



-44- 



WO 00/75775 



PCT/US00/15689 



C43: </Command> 

C44: <Response Status = "NormalEnding" Notify = "DoNotNotif y"> 

C45: <0ut>RFU_K/0ut> 

C4 6: <Out>memoryLeft</Out> 

5 C47: <Out>fileId</Out> 

. C48: <0ut>fileType</0ut> 

C49: <Out>fileFeatures</0ut> 

C50: <0ut>restOfResponse</0utx/Response> 

C5 1-: <-/-Apdu> , . 

10 C52: . " 

C53: <Apdu Id - "Select "> 

C54: <Command> 

C55: <Header Class = "OxAO" Ins - "0xA4" PI = "0" P2 = "0" Lc = 

C56:"2" Le = "0x20"/> 

15 C57: <In>gsmDirectory</In> 

C58: ~ </Command>- ■ 

C59: <Response Status = "NormalEnding" Notify = "DoNotNotif y"> 

C60: <0ut>RFU_K/0ut> 

C61: <Out>memoryLeft</Out> 

20 C62: <Out>fileId</Out> 

C63: <Out>fileType</Out> 

C64: <Out>f ileFeatures</Out> 

C65 : <Out>restOf Response</Outx/Response> 

C66: </Apdu> 
25 C67: 

C68: '<Apdu Id = "Select "> 

C69: <Command> 

C70: <Header Class « "OxAO" Ins = "0xA4" PI = "0" P2 = "0" Lc = 
C7i:"2" Le = "0x2O"/> 

30 C72: <In>imsiFile</In> 

C73: </Comraand> 

C74: <Response Status = "NormalEnding" Notify = "DoNotNotif y"> 

C75: <Out>RFU_K/Out> 

C76: <Out>memoryLeft</Out> 

35 C77: <Out>fileId</0ut> 

C78: <Out>fileType</Out> 

C7 9: <Out>fileFeatures</0ut> 

C80: <Out>restOf Response</Out></Response> 

C81: </Apdu> 
40 C82: 

C83: <Apdu Id - "Select"> 

C84: <Command> 

C85: <Header Class = "OxAO" Ins = "0xA4" PI - "0" P2 - "0" Lc = 
C86:"2" Le = "0x20V> 

45 C87: <In>telecomDirectory</In> 

C88: < /Commands 

C89: * <Response Status » "NormalEnding" Notify = "DoNotNotif y"> 

C90: <0ut>RFU_K/0ut> 

C91 : <Out>memoryLef t</Out> 

50 C92: <Out>fileId</Out> 

C93: <Out>fileType</Out> 

C94: , <Out>fileFeatures</Out> 

C95: <Out>restOfResponse</Outx/Response> 

C96: </Apdu> y 
55 C97: </Process> 

C98: 

C99: <Process Name = "getFile"> 

.45- 
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C100: <Doc>This is the description of the getFile process to retreive the 
C101:path</Doc> 

C102; <Doc> of the XML ! file related to the Gemplus 1 GemXpresso smart 
C103:card</Doc> 
5 C104: <Apdu Id = "returnFiienarae"> 
C105: <Command> 

C106: <Header Class = "0x00" Ins - "0x00" PI = "0" P2 = "0" Le = 

C107:"0x00"/> 

C 108.: < Iji>^J^:jV^d^\^^ 

10 C109:developments\\xml\\sml\Samples\GsmLoyalTyATsmr""<7In^ 

C110: </Command> 

Clll: . <Response Status = "NormalEnding" Notify = "DoNotNotif y"> 

C112: <Out>"Void"</Outx/Response> 
C113: </Apdu> - 
15 C114: </Process> 

C : l-15 : <7Profi-le>- . _ __ 

C116: " 

C117:<Profile Type = "GemClub" Version = "0.1 "> 

C118: <Signatuire Type = "Application">"signature"</Signature> 
20 C119: 

C120: <Process Name - "signature"> 

C121: <Doc>This is the description of the getFile process to retreive the 
C122:path</Doc> 

C123: <Doc> of the XML file related to the Gemplus' GemClub smart 
25 C124 :card</Doc> 

C125: <Doc> step' 1 - get the card inf ormation</Doc> 
C126: 

C127: <Variable Name =. "CardSerialNumber" Type = "byteArray" Length = 

C128:"8" Default = ""/> 
30 C129: <Variable Name = "Unknownl" Type = "byteArray" Length = "8" 

C130:Default » ""/> . 

C131: <Variable Name ~ "Unknown2" Type = "byteArray" Length = "8" 

C132:Default = ""/> 

C133: <Variable Name = "IssuerRef erence" Type = "byteArray" Length = 

35 "4" C134: Default = ""/> 

C135: <Apdu Id = "GetCardlnf o"> 
C136: <Command> 

C137: <Header Class = "0x80" Ins « "OxBE" PI = "0" P2 = "0" Le = 

C138:"0xlC M /> 
40 C139: <In>"Void"</In> 
C140: </Commahd> 

C141: <Response Status = "NormalEnding" Notify = "DoNotNotif y"> 

C142: <0ut>UnknownK/0ut> 
C143: <0ut>Unknown2</0ut> 
45 C144: <Out>CardSerialNumber</Out> 

C145 : <Out>IssuerRef erence</Outx/Response> 

C14 6: </Apdu> 
C147: </Process> 
C148: 

50 C14 9: <Process Name = "getFile"> 

C150: <Doc>This is the description of the getFile process to 

retreive C151:the path</Doc> 

C152: <Doc> of the XML file related to the Gemplus' GemClub smart 

C153:card</Doc> 
55 C154: <Apdu Id = "returnFilename"> 

CI 55: <Command> 

C156: <Header Class - "0x00" Ins = "0x00" PI = "0" P2 = "0" Lc 

- C157:"0" Le = "0"/> 
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C158: <In>"file:////c:\\my 

C159 : developments \ \xml \ \sml \Samples\GemClubLoyalty ; sml "</In> 
C160: </Command> 

C161: <Response Status = "Normal Ending" Notify = "DoNotNotif y"> 

5 C162: <Out>"Void"</Outx/Response> 
CI 63: </Apdu> 
C164: </Process> 
C165:</Profile> 

C1.66-: 

10 C167:<StatusWord> " ~ ' - : 

C168: <SW Verbose = "NormalEnding" Status = "0x9000"/> 

CI 69 : </StatusWord> 

C170: 

C171:<Manifest> 
15 C172: <Principal/> 

----- C173: <Digestx/Digest> 

C174: <DicSignaturex/DicSignature> ~ ~~ — ~ 

C175: <Certif icatex/Certif icate> 
C176:</Manifest> 
20 C177:</CardDocument> 

While the application protocol and boot file examples described above are written in 
XML, alternate embodiments of the present invention could use different versions of XML, 
or different languages or implementations, to provide the description. Additionally, the boot 
file and application protocol need not be written in the same language, as is done in the 

25 present example. 

While the application logic unit in the above example is written in Java, alternate 
embodiments of the present invention could use other computer languages for the 
implementation of the logic of the application. 

The present invention allows a developer of application software to write an 

30 application logic unit without concern for the particular hardware implementation of readers, 
computers, or smart cards. Through the linking engine, the present invention retrieves the 
hardware specific description of the logical processes of the application logic unit. The 
linking engine matches the identifiers specifying the hardware used, the reader, smart card 
and any computer, to the process called for the in application logic unit. Accordingly, the 

35 present invention has the advantage of allowing an application developer to write applications 
that may be implemented on any combination of terminal or smart device with an existing 
dictionary for the combination of terminal and smart device. The present invention reduces 
the burden on the memory of the terminal by allowing hardware specific portions of the 
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application to be downloaded for a specific smart device, thereby eliminating the need to 
store hardware specific functional elements of the application related to the smart device. 

The present invention allows other smart cards, or other types of smart devices, to be 
added as compatible with the application logic unit by either adding to the existing boot file, 
5 or using a new boot file with the scanning information for the new smart card. IntHisTmanner 
the present invention, as illustrated by the examples contained herein, provides enhanced 
flexibility and interoperability among different smart device types through the addition of 
boot files and dictionaries without the need to modify" the~existing~application logic unit.- - — 

While the preferred embodiment of the present invention links the application 
10 protocol to the application logic unit, alternate embodiments of the present invention may 
perform the linking operation prior to run time. 
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CLAIMS 

1 claim: 

1 . A terminal for running an application program for processing data in 



5 connection with a smart device, comprising: ~~ 
an application logic unit providing the hardware independent description of the logic 

of the application program; and 

an identifier specifying the location of an appTic^ioiTproFocorproviding thehardware 

description of the application program. 

10 

2. The terminal of claim 1 , wherein the terminal further comprises: 
a means for linking the application logic unit to the application protocol to implement 
the logical processes of the application logic unit in connection with the smart device. 

15 3. The terminal of claim 1 , wherein the identifier corresponds to a memory 

location on the smart device. 

4. The terminal of claim 1 , wherein the identifier corresponds to a memory 
location accessible through a network connection. 

20 

5. The terminal of claim 1 , wherein the identifier corresponds to a memory 
location on the terminal. 

6. The terminal of claim 2, wherein the means for linking performs a 

25 compatibility test prior to linking the application protocol to the application logic unit. 
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7. The terminal of claim 6, wherein the means for linking performs the 
compatibility test on a plurality of dictionaries prior to selecting a dictionary for sue as the 
application protocol. 



5 8. A smart device used in connection with a terminal for running an application 

program for processing data, comprising: 
a memory unit; and 

an identifier located in the memory unit specifying the location of an application— — 
protocol, the application protocol providing the hardware description of the application 
1 0 program. 

9. A method for running an application program for processing data in 
connection with a smart device, the method comprising the steps of: 

initiating the running of an application logic unit; 
1 5 initiating the testing of at least one dictionary for compatibility with the hardware 

implementation, 

selecting a dictionary for use as the application protocol based on the outcome of the 
compatibility test; 

linking the selected dictionary to the application logic unit for use as the application 
20 protocol; and 

implementing the logic of the application logic unit using the definitions contained in 
the application protocol. 

1 0. A method of linking a dictionary to an application logic unit to implement the 
25 application logic unit, comprising: 

receiving a request from an application logic unit to find a dictionary compatible with 
the hardware implementation present at the time the application logic unit makes the request; 
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retrieving a list including at least one identifier of a potentially compatible dictionary; 
selecting a dictionary for compatibility testing from the list of potentially compatible 
dictionaries; 

retrieving the selected dictionary; 



5 running a boot to scan the dictionary for segments of the dictionary used in the 

compatibility test; 

generating a output value corresponding to the selected dictionary; 
comparing the output value to a boot check value; ~ 
including the selected dictionary on a compatible dictionary list if the output value is 
1 0 equivalent to the bootcheck value; 

selecting a dictionary from the compatible dictionary list for use as the application 
protocol; and 

linking the dictionary selected from the compatible dictionary list to the application 
logic unit for use in implementing the application logic unit. 

15 

1 1 . The method of linking the application logic unit to the application protocol of 
claim 10, wherein at least one additional dictionary is selected for compatibility testing. 

12. The method of linking the application logic unit to the application protocol of 
20 claim 1 1, wherein additional dictionaries are included on the compatible dictionary list when 

the corresponding output value of the tested dictionary is equivalent to the bootcheck value. 

13. The method of linking the application logic unit to the application protocol of 
claim 1 1 wherein all the dictionaries on the list of potentially compatible dictionaries are 

25 tested for compatibility. 
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14. The method of linking the application logic unit to the application protocol of 
claim 1 1 wherein all dictionaries are included on the compatible dictionary list where the 
dictionary output value is equivalent to the bootcheck value. 

15. The method of linking the application logic unit to the application protocol of 
claim 13 wherein all dictionaries are included on the compatible dictionary list where the 
dictionary output value is equivalent to the bootcheck value. 

1 6. A method of running an application program, comprising the steps of: 
creating a profile for the application protocol; 

establishing a linking engine; 

initiating a test of at least one dictionary for compatibility with the hardware 
implementation and an application logic unit; 

selecting a dictionary for use of as the application protocol based on the outcome of 
the compatibility test; 

invoking at least one smart device method; and 

receiving an output response based on a definition of the invoked smart device 
method, the definition of the invoked smart card method contained in the application 
protocol. 



17. A application program for processing data in connection with data processed 
on a smart device, comprising: 

an application logic unit specifying the logic performed in processing the data, the 
application logic unit including at least one smart device method; and 



-52- 



WO 00/75775 PCT/USOO/15689 

an application protocol including a definition of the smart device method, the 
definition providing the hardware specific component of the smart device method. 

1 8. The a pplication program of claim 17, further comprising a boot file, the boot 

5 file specifying segments of a dictionary tested for compatibility as the application protocol 
for the application logic unit. 

1 9. The application program of claim 17, wherein the^applicatioh protocol is" - 
linked to the application logic unit by a linking engine. 

10 

20. The application program of claim 1 9, wherein the linking engine performs a 
compatibility test prior to linking the application protocol to the application logic unit. 

15 
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Figure 3 
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